<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="tooltip.vala" xml:lang="cs">
<info>
<title type="text">Tooltip (Vala)</title>
<link type="guide" xref="beginner.vala#misc"/>
<link type="seealso" xref="toolbar.vala"/>
<revision version="0.1" date="2013-06-18" status="review"/>
<credit type="author copyright">
<name>Tiffany Antopolski</name>
<email its:translate="no">tiffany.antopolski@gmail.com</email>
<years>2013</years>
</credit>
<desc>Přidání vysvětlivek do vašich widgetů</desc>
</info>
<title>Tooltip</title>
<media type="image" mime="image/png" src="media/tooltip.png"/>
<p>Nástrojová lišta s vysvětlivkami (s obrázky) u tlačítek.</p>
<note><p>Tento příklad vychází z příkladu <link xref="toolbar.vala">Toolbar</link>.</p></note>
<links type="section"/>
<section id="code">
<title>Kód použitý k vygenerování tohoto příkladu</title>
<code mime="text/x-csharp" style="numbered">/* Toto je okno */
class MyWindow : Gtk.ApplicationWindow {
/* Instance proměnných náležejících k oknu */
Gtk.Toolbar toolbar;
Gtk.ToolButton new_button;
Gtk.ToolButton open_button;
Gtk.ToolButton undo_button;
Gtk.ToolButton fullscreen_button;
Gtk.ToolButton leave_fullscreen_button;
/* Konstruktor */
internal MyWindow (MyApplication app) {
Object (application: app, title: "Toolbar with Tooltips Example");
this.set_default_size (400, 200);
var grid = new Gtk.Grid ();
this.add (grid);
grid.show ();
create_toolbar ();
toolbar.set_hexpand (true);
grid.attach (toolbar, 0, 0, 1, 1);
toolbar.show ();
/* Vytvoří akci "undo" okna */
var undo_action = new SimpleAction ("undo", null);
undo_action.activate.connect (undo_callback);
this.add_action (undo_action);
/* Vytvoří akci "fullscreen" okna */
var fullscreen_action = new SimpleAction ("fullscreen", null);
fullscreen_action.activate.connect (fullscreen_callback);
this.add_action (fullscreen_action);
}
/* Zpětné volání pro signál query_tooltip */
bool undo_tooltip_callback (int x, int y, bool keyboard_tooltip, Gtk.Tooltip tooltip) {
/* Nastaví text pro vysvětlivku */
tooltip.set_text ("Undo your last action");
/* Nastaví ikonu pro vysvětlivku */
tooltip.set_icon_from_stock("gtk-undo", Gtk.IconSize.MENU);
/* show the tooltip */
return true;
}
/* Tato funkce vytvoří nástrojovou lištu, její tlačítka
* ToolButton a přiřadí jim názvy akcí.*/
void create_toolbar () {
toolbar = new Gtk.Toolbar ();
toolbar.get_style_context ().add_class (Gtk.STYLE_CLASS_PRIMARY_TOOLBAR);
new_button = new Gtk.ToolButton.from_stock (Gtk.Stock.NEW);
/* Vysvětlivka s textem */
new_button.set_tooltip_text ("Create a new file");
new_button.is_important = true; //decides whether to show the label
toolbar.add (new_button);
new_button.show ();
new_button.action_name = "app.new";
open_button = new Gtk.ToolButton.from_stock (Gtk.Stock.OPEN);
/* Vysvětlivka používající značkovací jazyk Pango */
open_button.set_tooltip_markup ("Open an <i>existing</i> file");
open_button.is_important = true;
toolbar.add (open_button);
open_button.show ();
open_button.action_name = "app.open";
undo_button = new Gtk.ToolButton.from_stock (Gtk.Stock.UNDO);
/* Pro vysvětlivku, která bude mít obrázek, nejprve musíme nastavit
* set_has_tooltip na true */
(undo_button as Gtk.Widget).set_has_tooltip (true);
/* Napojí signál query_tooltip na zpětné volání */
undo_button.query_tooltip.connect (undo_tooltip_callback);
undo_button.is_important = true;
toolbar.add (undo_button);
undo_button.show ();
undo_button.action_name = "win.undo";
fullscreen_button = new Gtk.ToolButton.from_stock (Gtk.Stock.FULLSCREEN);
fullscreen_button.is_important = true;
toolbar.add (fullscreen_button);
fullscreen_button.show ();
fullscreen_button.action_name = "win.fullscreen";
leave_fullscreen_button = new Gtk.ToolButton.from_stock (Gtk.Stock.LEAVE_FULLSCREEN)
;
leave_fullscreen_button.is_important = true;
toolbar.add (leave_fullscreen_button);
leave_fullscreen_button.action_name = "win.fullscreen";
}
void undo_callback (SimpleAction simple, Variant? parameter) {
print ("You clicked \"Undo\".\n");
}
void fullscreen_callback (SimpleAction simple, Variant? parameter) {
if ((this.get_window ().get_state () & Gdk.WindowState.FULLSCREEN) != 0) {
this.unfullscreen ();
leave_fullscreen_button.hide ();
fullscreen_button.show ();
}
else {
this.fullscreen ();
fullscreen_button.hide ();
leave_fullscreen_button.show ();
}
}
}
/* Toto je aplikace */
class MyApplication : Gtk.Application {
protected override void activate () {
new MyWindow (this).show ();
}
protected override void startup () {
base.startup ();
/* Vytvoří akci "new" a přidá ji do aplikace */
var new_action = new SimpleAction ("new", null);
new_action.activate.connect (new_callback);
this.add_action (new_action);
/* Vytvoří akci "open" a přidá ji do aplikace */
var open_action = new SimpleAction ("open", null);
open_action.activate.connect (open_callback);
this.add_action (open_action);
/* Kdybychom chtěli, můžete přidat akci i do aplikační nabídky */
//var menu = new Menu ();
//menu.append ("New", "app.new");
//this.app_menu = menu;
}
void new_callback (SimpleAction action, Variant? parameter) {
print ("You clicked \"New\".\n");
}
void open_callback (SimpleAction action, Variant? parameter) {
print ("You clicked \"Open\".\n");
}
}
/* Funkce main vytvoří aplikaci a spustí ji */
int main (string[] args) {
return new MyApplication ().run (args);
}
</code>
</section>
<section id="references">
<title>Odkazy k API</title>
<p>V této ukázce se používá následující:</p>
<list>
<item><p><link href="http://www.valadoc.org/gtk+-3.0/Gtk.Tooltip.html">Gtk.Tooltip</link></p></item>
<item><p><link href="http://www.valadoc.org/gtk+-3.0/Gtk.Toolbar.html">Gtk.Toolbar</link></p></item>
<item><p><link href="http://www.valadoc.org/gtk+-3.0/Gtk.Widget.query_tooltip.html">Gtk.Widget.query_tooltip</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/3.4/gtk3-Stock-Items.html#GTK-STOCK-UNDO:CAPS">Standardní položky</link></p></item>
</list>
</section>
</page>