# Tooltip (Vala)

Tiffany Antopolski
tiffany.antopolski@gmail.com 2013
Přidání vysvětlivek do vašich widgetů

# Tooltip

Nástrojová lišta s vysvětlivkami (s obrázky) u tlačítek.

Tento příklad vychází z příkladu Toolbar.

# Kód použitý k vygenerování tohoto příkladu

/* 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); }

# Odkazy k API

V této ukázce se používá následující:

Gtk.Tooltip

Gtk.Toolbar

Gtk.Widget.query_tooltip

Standardní položky