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

  <info>

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

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

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

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

    <revision version="0.2" date="2012-08-01" status="stub"/>

    <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>Balí widgety do řádků a sloupců</desc>

  </info>

  <title>Grid</title>

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

  
Pár popisků v mřížce.

  <links type="section"/>

  <section id="code">

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

    from gi.repository import Gtk

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

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

        # Tři popisky

        label_top_left = Gtk.Label(label="This is Top Left")

        label_top_right = Gtk.Label(label="This is Top Right")

        label_bottom = Gtk.Label(label="This is Bottom")

        # Mřížka

        grid = Gtk.Grid()

        # Nějaké místo mezi sloupci v mřížce

        grid.set_column_spacing(20)

        # V mřížce:

        # Připojíme první popisek do levého horního rohu

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

        # Připojíme druhý popisek

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

        # Připojíme třetí popisek pod první popisek

        grid.attach_next_to(

            label_bottom, label_top_left, Gtk.PositionType.BOTTOM, 2, 1)

        # Přidá mřížku do okna

        self.add(grid)

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="methods">

    <title>Užitečné metody pro widget Grid</title>

    <list>

      <item>
Pro připojení widgetu potomek na pozici zleva, shora s danou šířkou, výškou použijte attach(potomek, shora, zleva, šířka, výška). Pokud je již umístěn widget sourozenec, můžeme použít také attach_next_to(potomek, sourozenec, strana, šířka, výška), kde strana je jedno z Gtk.PositionType.LEFT, Gtk.PositionType.RIGHT, Gtk.PositionType.TOP, Gtk.PositionType.BOTTOM.
</item>

      <item>
insert_row(pozice) a insert_column(pozice) vkládají řádek respektive sloupec. Potomci, kteří jsou na této pozici nebo pod ní jsou posunuti o řádek níž a potomci roztažní přes tuto pozici se roztáhnou i přes nový řádek. insert_next_to(sourozenec, strana) vloží řádek nebo sloupec na zadanou pozici. Nový řádek nebo sloupec je umístěn vedle sourozence na straně určené argumentem strana. Pokud strana je Gtk.PositionType.TOP nebo Gtk.PositionType.BOTTOM, je vložen řádek, pokud Gtk.PositionType.LEFT nebo Gtk.PositionType.RIGHT, je vložen sloupec.
</item>

      <item>
set_row_homogeneous(True) a set_column_homogeneous(True) zajistí, že každý řádek respektive sloupec bude mít stejnou výšku respektive šířku.
</item>

      <item>
set_row_spacing(rozestup) a set_column_spacing(rozestup) vynutí rozestup mezi řádky respektive sloupci. Hodnota rozestup může být mezi 0, což je výchozí hodnota, a 32767.
</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/GtkApplication.html">GtkApplication</link>
</item>

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

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

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

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

    </list>

  </section>

</page>