<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="toolbar_builder.vala" xml:lang="cs">

  <info>

  <title type="text">Nástrojová lišta vytvořená pomocí Glade (Vala)</title>

    <link type="guide" xref="beginner.vala#menu-combo-toolbar"/>

    <link type="seealso" xref="toolbar.vala"/>

    <link type="seealso" xref="grid.vala"/>

    <revision version="0.1" date="2012-05-08" status="draft"/>

    <credit type="author copyright">

      <name>Tiffany Antopolski</name>

      <email its:translate="no">tiffany.antopolski@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>Lišta s tlačítky</desc>

  </info>

  <title>Toolbar (vytvořený pomocí Glade)</title>

  <media type="image" mime="image/png" src="media/toolbar.png"/>

  
Tento příklad je podobný na <link xref="toolbar.vala"/> s tím rozdílem, že k vytvoření nástrojové lišty v souboru .ui ve formátu XML použijeme návrhář Glade.

  
Když chcete vytvořit nástrojovou lištu pomocí <link href="http://glade.gnome.org/">návrháře rozhraní Glade</link>:

  <steps>

    <item>
Otevřete Glade a uložte soubor jako <file>toolbar_builder.ui</file>.

          
<media type="image" src="media/glade_ui.png" width="900">Snímek obrazovky s uživatelským rozhraním Glade</media>

    </item>

    <item>
V <gui>Kontejnerech</gui> na levé straně klikněte pravým tlačítkem na ikonu nástrojové lišty a vyberte <gui>Přidat widget do nejvyšší úrovně</gui>.

          
<media type="image" src="media/glade_select_toolbar.png">Snímek obrazovky s ikonou nástrojové lišty v uživatelském rozhraní Glade</media>

    </item>

    <item>
Na kartě <gui>Obecné</gui> vpravo dole změňte <gui>Název</gui> na <input>toolbar</input> a <gui>Zobrazovat šipku</gui> na <gui>Ne</gui>.

          
<media type="image" src="media/glade_toolbar_general.png">Snímek obrazovky s kartou Obecné</media>

    </item>

    <item>
Na kartě <gui>Běžné</gui> nastavte <gui>Roztáhnout vodorovně</gui> na <gui>Ano</gui>.

         
<media type="image" src="media/glade_toolbar_common.png">Snímek obrazovky s kartou Běžné</media>

     </item>

     <item>
Klikněte pravým tlačítkem na „toolbar“ vpravo nahoře a vyberte <gui>Upravit</gui>. Objeví se okno <gui>Editor nástrojové lišty</gui>.

         
<media type="image" src="media/glade_toolbar_edit.png">Snímek obrazovky, na kterém je kliknuto pravým tlačítkem kvůli úpravě nástrojové lišty</media>

   </item>

   <item>
Chceme přidat 5 tlačítek ToolButton: „New“, „Open“, „Undo“, „Fullscreen“ a „Leave Fullscreen“. Nejprve přidáme ToolButton „New“.

     <steps>

       <item>
Na kartě <gui>Hierarchie</gui> klikněte na <gui>Přidat</gui>.
</item>

       <item>
Změňte název „toolbutton1“ na „new_button“.
</item>

       <item>
Posuňte se dolů a nastavte <gui>Je důležitá</gui> na <gui>Ano</gui>. To způsobí, že když je zobrazena nástrojová lišta, bude nástrojovém tlačítku zobrazen popisek.
</item>

       <item>
Zadejte <gui>Název akce</gui>: <input>app.new</input>.
</item>

       <item>
Změňte <gui>Popisek</gui> na <input>New</input>.
</item>

       <item>
V rozbalovacím seznamu zvolte <gui>New</gui> jako <gui>Standadní ID</gui> nebo napište <input>gtk-new</input>.
</item>

     </steps>

     
Opakujte předchozí kroky pro zbývající tlačítka ToolButton s následujícími vlastnostmi:

        
Name

        
Je důležitá

        
Název akce

        
Label

        
Standardní ID

      
open_button

      
Ano

      
app.open

      
Open

      
gtk-open

      
undo_button

      
Ano

      
win.undo

      
Undo

      
gtk-undo

      
fullscreen_button

      
Ano

      
win.fullscreen

      
Fullscreen

      
gtk-fullscreen

      
leave_fullscreen_button

      
Ano

      
win.fullscreen

      
Leave Fullscreen

      
gtk-leave-fullscreen

          <media type="image" src="media/glade_toolbar_editor.png">

          </media>

    </item>

    <item>
Zavřete <gui>Editor panelu nástrojů</gui>.

   </item>

   <item>
Když svůj program spustíte, nechcete aby bylo zobrazené nástrojové tlačítko <gui>Leave Fullscreen</gui>, protože aplikace není v režimu celé obrazovky. Můžete to nastavit na kartě <gui>Běžné</gui>, kde přepnete vlastnost <gui>Viditelný</gui> na <gui>Ne</gui>. Nástrojové tlačítko si bude pořád viditelné v návrháři rozhraní, ale po načtení do vašeho programu se bude chovat podle očekávání.

          
<media type="image" src="media/glade_visible_no.png">Nastavení vlastnosti Viditelná na Ne</media>

   </item>

    <item>
Uložte svoji práci a zavřete Glade.

   </item>

   <item>
Soubor XML vytvořený v <app>Glade</app> je zobrazen níže. Jedná se o popis nástrojové lišty. V době, kdy bylo toto psáno, neexistovala v uživatelském rozhraní <app>Glade</app> volba pro přidání třídy Gtk.STYLE_CLASS_PRIMARY_TOOLBAR. Můžeme ji ale do souboru XML přidat ručně. Udělá se to přidáním následujícího kódu XML na řádek 9 v <file>toolbar_builder.ui</file>:

  <style>

     <class name="primary-toolbar"/>

  </style>

  
Pokud tuto část nepřidáte, bude program i tak fungovat dobře. Akorát výsledná nástrojová lišty bude vypadat lehce odlišně než ta na snímku obrazovky na začátku této stránky.

   </item>

</steps>

  <?xml version="1.0" encoding="UTF-8"?>

<interface>

  <!-- interface-requires gtk+ 3.0 -->

  <object class="GtkToolbar" id="toolbar">

    <property name="visible">True</property>

    <property name="can_focus">False</property>

    <property name="hexpand">True</property>

    <property name="show_arrow">False</property>

    <child>

      <object class="GtkToolButton" id="new_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">app.new</property>

        <property name="label" translatable="yes">New</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-new</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="open_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">app.open</property>

        <property name="label" translatable="yes">Open</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-open</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="undo_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">win.undo</property>

        <property name="label" translatable="yes">Undo</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-undo</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="fullscreen_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">win.fullscreen</property>

        <property name="label" translatable="yes">Fullscreen</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-fullscreen</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="leave_fullscreen_button">

        <property name="use_action_appearance">False</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">win.fullscreen</property>

        <property name="label" translatable="yes">Leave Fullscreen</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-leave-fullscreen</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

  </object>

</interface>

  
Nyní vytvoříme kód zobrazený níže, který přidá nástrojovou lištu ze souboru, který jsme právě vytvořili.

/* Toto je okno */

class MyWindow : Gtk.ApplicationWindow {

	/* Deklarace dvou widgetů ToolButton, protože je získáme

	 * ze souboru .ui (viz řádky 32 a 33), tak abchom je mohli

	 * podle potřeby skrýt a zobrazit */

	Gtk.ToolButton fullscreen_button;

	Gtk.ToolButton leave_fullscreen_button;

	/* Konstruktor */

	internal MyWindow (MyApplication app) {

		Object (application: app, title: "Toolbar Example");

		this.set_default_size (400, 200);

		var grid = new Gtk.Grid ();

		this.add (grid);

		grid.show ();

		/* Přidá nástrojovou lištu ze souboru .ui */

		var builder = new Gtk.Builder ();

		try {

			builder.add_from_file ("toolbar_builder.ui");

		}

		/* Obsluha výjimky */

		catch (Error e) {

			error ("Unable to load file: %s", e.message);

		}

		grid.attach (builder.get_object ("toolbar") as Gtk.Toolbar, 0, 0, 1, 1);

		/* Získá tyto objekty ze souboru .ui, takže se můžeme mezi nimi přepínat */

		fullscreen_button = builder.get_object ("fullscreen_button") as Gtk.ToolButton;

		leave_fullscreen_button = builder.get_object ("leave_fullscreen_button") as Gtk.ToolButton;

		/* Vytvoří akci "undo" (akce okna) */

		var undo_action = new SimpleAction ("undo", null);

		undo_action.activate.connect (undo_callback);

		this.add_action (undo_action);

		/* Vytvoří akci "fullscreen" (akce okna) */

		var fullscreen_action = new SimpleAction ("fullscreen", null);

		fullscreen_action.activate.connect (fullscreen_callback);

		this.add_action (fullscreen_action);

	}

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

		/* Kdbyste chtěli, mohli byste akci přidat 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);

}

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

<list>

  <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.ToolButton.html">Gtk.Toolbutton</link>
</item>

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

</list>

</page>