<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"/>

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

  <note>
Tento příklad vychází z příkladu <link xref="toolbar.vala">Toolbar</link>.
</note>

  <links type="section"/>

  <section id="code">

  <title>Kód použitý k vygenerování tohoto příkladu</title>

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

}

  </section>

  <section id="references">

  <title>Odkazy k API</title>

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

    <list>

      <item>
<link href="http://www.valadoc.org/gtk+-3.0/Gtk.Tooltip.html">Gtk.Tooltip</link>
</item>

      <item>
<link href="http://www.valadoc.org/gtk+-3.0/Gtk.Toolbar.html">Gtk.Toolbar</link>
</item>

      <item>
<link href="http://www.valadoc.org/gtk+-3.0/Gtk.Widget.query_tooltip.html">Gtk.Widget.query_tooltip</link>
</item>

      <item>
<link href="https://developer.gnome.org/gtk3/3.4/gtk3-Stock-Items.html#GTK-STOCK-UNDO:CAPS">Standardní položky</link>
</item>

    </list>

  </section>

</page>