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

  <info>

    <title type="text">GMenu (Python)</title>

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

    <link type="seealso" xref="signals-callbacks.py"/>

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

    <revision version="0.1" date="2012-04-28" 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">

      <name>Marta Maria Casetti</name>

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

      <years>2012</years>

    </credit>

    <desc>Jednoduchá implementace GMenu.</desc>

  </info>

  <title>GMenu</title>

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

  
GtkApplication s jednoduchým widgetem GMenu a objekty SimpleAction

  <links type="section"/>

  <section id="code">

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

    from gi.repository import Gtk

from gi.repository import Gio

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

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

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        # Spustí aplikaci

        Gtk.Application.do_startup(self)

        # Vytvoří nabídku

        menu = Gio.Menu()

        # Připojí do nabídky tři volby

        menu.append("New", "app.new")

        menu.append("About", "app.about")

        menu.append("Quit", "app.quit")

        # Nastaví nabídku jako aplikační nabídku

        self.set_app_menu(menu)

        # Vytvoří akci pro volbu "new" v nabídce

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

        # Napojí ji na funkci zpětného volání new_cb

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

        # Přidá akci do aplikace

        self.add_action(new_action)

        # Volba "about"

        about_action = Gio.SimpleAction.new("about", None)

        about_action.connect("activate", self.about_cb)

        self.add_action(about_action)

        # Volba "quit"

        quit_action = Gio.SimpleAction.new("quit", None)

        quit_action.connect("activate", self.quit_cb)

        self.add_action(quit_action)

    # Funkce zpětného volání pro "new"

    def new_cb(self, action, parameter):

        print("This does nothing. It is only a demonstration.")

    # Funkce zpětného volání pro "about"

    def about_cb(self, action, parameter):

        print("No AboutDialog for you. This is only a demonstration.")

    # Funkce zpětného volání pro "quit"

    def quit_cb(self, action, parameter):

        print("You have quit.")

        self.quit()

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="methods">

    <title>Užitečné metody pro GSimpleAction a GMenu</title>

    
Na řádku 33 je signál "activate" od činnosti new_action (což není nabídka!) napojen na funkci zpětného volání new_cb() pomocí action.connect(signál, funkce zpětného volání). Podrobnější vysvětlení viz <link xref="signals-callbacks.py"/>.

    
Užitečné metody pro GSimpleAction:

    <list>

      <item>
K vytvoření nové akce, která je bezstavová, což znamená, že akce neuchovává stav nebo nezávisí na stavu daném akcí samotnou, použijte:

action = Gio.SimpleAction.new("název", typ_parametru)

      
kde "název" je název akce a typ_parametru je typ parametrů, která akce přijímá při aktivaci. Může to být None nebo GLib.VariantType.new('s'), když je parametr typu string. Místo 's' můžete použít i jiné znaky popsané <link href="http://developer.gnome.org/glib/unstable/glib-GVariantType.html">zde</link>. K vytvoření stavové akce použijte:

action = Gio.SimpleAction.new_stateful("název", typ_parametru, počáteční_stav)

      
kde počáteční_stav je definován jako GVariant, například Glib.Variant.new_string("start"). Seznam možných stavů najdete <link href="http://developer.gnome.org/glib/unstable/glib-GVariant.html">zde</link>.
</item>

      <item>
set_enabled(True) nastavuje akci jako povolenou. Akce musí být povolená, aby šla aktivovat nebo aby šel její stav změnit voláním zvenku. Mělo by být voláno jen implementátorem akce. Uživatel akce by neměl zkoušel měnit tento její příznak.
</item>

      <item>
set_state(stav), kde stav je GVariant, nastavuje stav akce a tím aktualizuje vlastnost state na zadanou hodnotu. Mělo by být voláno jen implementátorem akce. Uživatel akce by měl při požadavku na změnu místo toho volat change_state(stav) (kde stav byl zmíně v předchozím).
</item>

    </list>

    
Užitečné metody pro GMenu:

    <list>

      <item>
K vložení položky do nabídky na pozici pozice použijte insert(pozice, popisek, upřesnění_akce), kde popisek je text, který se v nabídce objeví a upřesnění_akce je složený řetězec v podobě názvu akce, před který se připojí předpona app.. Podrobnější rozebrání této záležitosti můžete najít v <link xref="menubar.py#win-app"/>.

      
Pro připojení položky do nabídky na konec respektive na začátek použijte append(popisek, upřesnění_akce) respektive prepend(popisek, upřesnění_akce).
</item>

      <item>
Jiným způsobem, jak přidat položky do nabídky, je vytvořit je jako widgety GMenuItem a použít insert_item(pozice, položka), append_item(položka) nebo prepend_item(položka). Takže například můžeme mít:

about = Gio.MenuItem.new("About", "app.about")

menu.append_item(about)

      </item>

      <item>
Do nabídky můžeme také přidat celý pododdíl pomocí insert_section(pozice, popisek, oddíl), append_section(popisek, oddíl) nebo prepend_section(popisek, oddíl), kde popisek je název pododdílu.
</item>

      <item>
Přidáme také celou podnabídku, která se bude rozbalovat a sbalovat, pomocí insert_submenu(pozice, popisek, oddíl), append_submenu(popisek, oddíl) nebo prepend_submenu(popisek, oddíl), kde popisek jen název pododdílu.
</item>

      <item>
K odstranění položky z nabídky použijte remove(pozice).
</item>

      <item>
K nastavení popisku pro nabídku použijte set_label(popisek).
</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/gio/unstable/GMenu.html">GMenu</link>
</item>

      <item>
<link href="http://developer.gnome.org/gio/stable/GSimpleAction.html">GSimpleAction</link>
</item>

      <item>
<link href="http://developer.gnome.org/glib/unstable/glib-GVariantType.html">GVariantType</link>
</item>

      <item>
<link href="http://developer.gnome.org/glib/unstable/glib-GVariant.html">GVariant</link>
</item>

    </list>

  </section>

</page>