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

  <info>

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

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

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

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

    <link type="next" xref="menubar.py"/>

    <revision version="0.1" date="2012-07-17" status="draft"/>

    <credit type="author copyright">

      <name>Tiffany Antopolski</name>

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

      <years>2012</years>

    </credit>

    <credit type="author copyright edit">

      <name>Marta Maria Casetti</name>

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

      <years>2012</years>

    </credit>

    <credit type="author copyright">

      <name>Sebastian Pölsterl</name>

      <email its:translate="no">sebp@k-d-w.org</email>

      <years>2011</years>

    </credit>

    <desc>Lišta s tlačítky a dalšími widgety</desc>

  </info>

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

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

  
Tento příklad je podobný příkladu <link xref="toolbar.py"/> 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.

<links type="sections"/>

<section id="glade">

<title>Vytvoření nástrojové lišty pomocí Glade</title>

  
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 sice 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í. Upozorňujeme, že jakékoliv použití metody show_all() by toto nastavení přepsalo, takže v celém kódu musíme používat show() zvlášť pro každý prvek.

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

</section>

<section id="code">

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

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

from gi.repository import Gtk

from gi.repository import Gdk

from gi.repository import Gio

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

        Gtk.Window.__init__(self, title="Toolbar Example", application=app)

        self.set_default_size(400, 200)

        # Mřížka pro připojení nástrojové lišty (viz dále)

        grid = Gtk.Grid()

        self.add(grid)

        # Musí zobrazit mřížku (a tím nástrojovou lištu) pomocí show(),

        # protože show_all() by zobrazilo a tlačítka na liště, která ale

        # chceme skrytá (kvůli tlačítku leave_fullscreen)

        grid.show()

        # Builder pro přidání návrhu uživatelského rozhraní navrženého

        # v Glade do mřížky:

        builder = Gtk.Builder()

        # Získá soubor (pokud existuje)

        try:

            builder.add_from_file("toolbar_builder.ui")

        except:

            print("file not found")

            sys.exit()

        # A připojí jej do mřížky

        grid.attach(builder.get_object("toolbar"), 0, 0, 1, 1)

        # Dvě tlačítka, která budo použita později v metodě

        self.fullscreen_button = builder.get_object("fullscreen_button")

        self.leave_fullscreen_button = builder.get_object(

            "leave_fullscreen_button")

        # Vytvoří akce, které ovládají okno, napojí jejich signály na metodu

        # zpětného volání (viz dále), přidá akce do okna:

        # Akce "undo"

        undo_action = Gio.SimpleAction.new("undo", None)

        undo_action.connect("activate", self.undo_callback)

        self.add_action(undo_action)

        # Akce "fullscreen"

        fullscreen_action = Gio.SimpleAction.new("fullscreen", None)

        fullscreen_action.connect("activate", self.fullscreen_callback)

        self.add_action(fullscreen_action)

    # Zpětné volání pro "undo"

    def undo_callback(self, action, parameter):

        print("You clicked \"Undo\".")

    # Zpětné volání pro "fullscreen"

    def fullscreen_callback(self, action, parameter):

        # Zkontroluje, jestli je stav stejný jako Gdk.WindowState.FULLSCREEN,

        # což je bitový příznak

        is_fullscreen = self.get_window().get_state(

        ) & Gdk.WindowState.FULLSCREEN != 0

        if is_fullscreen:

            self.unfullscreen()

            self.leave_fullscreen_button.hide()

            self.fullscreen_button.show()

        else:

            self.fullscreen()

            self.fullscreen_button.hide()

            self.leave_fullscreen_button.show()

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        # Zobrazí okno pomocí show(), ne show_all(), protože to by zobrazilo

        # také tlačítko leave_fullscreen

        win.show()

    def do_startup(self):

        Gtk.Application.do_startup(self)

        # Akce, které ovládají aplikace: vytvoří je, napojí jejich signály na

        # metody zpětného volání (viz dále), přidá akce do aplikace

        # Akce "new"

        new_action = Gio.SimpleAction.new("new", None)

        new_action.connect("activate", self.new_callback)

        app.add_action(new_action)

        # Akce "open"

        open_action = Gio.SimpleAction.new("open", None)

        open_action.connect("activate", self.open_callback)

        app.add_action(open_action)

    # Zpětné volání pro "new"

    def new_callback(self, action, parameter):

        print("You clicked \"New\".")

    # Zpětné volání pro "open"

    def open_callback(self, action, parameter):

        print("You clicked \"Open\".")

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

</section>

<section id="methods">

<title>Užitečné metody pro Gtk.Builder</title>

Na užitečné metody pro widget Toolbar se podívejte do kapitoly <link xref="toolbar.py"/>

Gtk.Builder sestaví uživatelské rozhraní z definice ve formátu XML.

<list>

<item>
add_from_file(název_souboru) načte a zpracuje zadaný soubor a sloučí jej s aktuálním obsahem v Gtk.Builder.
</item>

<item>
add_from_string(řetězec) zpracuje zadaný řetězec a sloučí jej s aktuálním obsahem v Gtk.Builder.
</item>

<item>
add_objects_from_file(název_souboru, id_objektů) je stejná jako add_from_file(), akorát že načte jen objekty, jejichž ID je uvedeno v seznamu id_objektů.
</item>

<item>
add_objects_from_string(řetězec, id_objektů) je stejná jako add_from_string(), akorát že načte jen objekty, jejichž ID je uvedeno v seznamu id_objektů.
</item>

<item>
get_object(id_objektu) získá widget s ID id_objektu ze seznamu načtených objektů v Gtk.Builder.
</item>

<item>
get_objects() vrátí všechny načtené objekty.
</item>

<item>
connect_signals(obsluhující_objekt) napojí signál na metodu zadanou v obsluhující_objekt. Může se jednat o libovolný objekt obsahující klíče a atributy, které jsou volány podobně jako název obsluhy signálu zadaný v popisu rozhraní, např. třída nebo slovník. Na řádku 39 je signál "activate" z akce undo_action napojen na funkci zpětného volání undo_callback() pomocí action.connect(signal, callback function). Podrobnější vysvětlení viz <link xref="signals-callbacks.py"/>.

</item>

</list>

</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://developer.gnome.org/gtk3/unstable/GtkGrid.html">GtkGrid</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkBuilder.html">GtkBuilder</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkWidget.html">GtkWidget</link>
</item>

  <item>
<link href="http://developer.gnome.org/gdk3/unstable/gdk3-Event-Structures.html#GdkEventWindowState">Struktury událostí</link>
</item>

</list>

</section>

</page>