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

  <info>

  <title type="text">MenuButton</title>

    <link type="guide" xref="beginner.py#buttons"/>

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

    <revision version="0.1" date="2012-08-19" 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>Tlačítko, které po kliknutí zobrazí nabídku</desc>

  </info>

  <title>MenuButton</title>

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

  
Widget GtkMenuButton se používá k zobrazení nabídky po kliknutí na něj. Nabídka může být poskytnuta v podobě GtkMenu nebo jako abstraktní GMenuModel. Tlačítko může obsahovat libovolný platný synovský widget. To znamená, že může obsahovat většinu ostatních standardních potomků GtkWidget. Nejčastěji používaným vloženým widgetem je GtkArrow.

  <note>
Musíte používat GNOME 3.6 nebo novější, aby widget MenuButton fungoval.
</note>

  <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="Menubutton Example", application=app)

        self.set_default_size(600, 400)

        grid = Gtk.Grid()

        # Tlačítko s nabídkou

        menubutton = Gtk.MenuButton()

        menubutton.set_size_request(80, 35)

        grid.attach(menubutton, 0, 0, 1, 1)

        # Nabídka se dvěmi akcemi

        menumodel = Gio.Menu()

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

        menumodel.append("About", "win.about")

        # Podnabídka s jednou akcí pro nabídku

        submenu = Gio.Menu()

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

        menumodel.append_submenu("Other", submenu)

        # Nabídka je nastavena jako nabídka pro MenuButton

        menubutton.set_menu_model(menumodel)

        # Akce vztahující se k oknu ("about")

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

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

        self.add_action(about_action)

        self.add(grid)

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

    def about_callback(self, action, parameter):

        print("You clicked \"About\"")

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

        Gtk.Application.do_startup(self)

        # Akce vztahující se k aplikaci

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

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

        self.add_action(new_action)

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

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

        self.add_action(quit_action)

    # Funkce zpětného volání pro akce vtahující se k aplikaci

    def new_callback(self, action, parameter):

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

    def quit_callback(self, action, parameter):

        print("You clicked \"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 widget MenuButton</title>

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

    
Umístění nabídky je určeno vlastností "direction" (směr) tlačítka s nabídkou a vlastnostmi "halign" (vodorovné zarovnání) nebo "valign" (svislé zarovnání) nabídky. Například, když je směr Gtk.ArrowType.DOWN (další volba je UP) a vodorovné zarovnání je Gtk.Align.START (další volby jsou CENTER a END), bude nabídka umístěna pod tlačítkem s počáteční hranou (v závislosti na směru textu) nabídky zarovnanou s počáteční hranou tlačítka. Jestliže pod tlačítkem není dostatek místa, vyskočí místo toho nabídka nahoru. Když by zarovnání posunulo část nabídky mimo obrazovku, natlačí se do viditelné části. 

    
V případě svislého zarovnání jsou možné směry šipky LEFT a RIGHT a svislé zarovnání je START, CENTER nebo END.

    
K nastavení těchto vlastností můžete použít set_align_widget(zarovnání) a set_direction(směr).

  </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/GtkMenuButton.html">MenuButton</link>
</item>

    </list>

  </section>

</page>