xmlns:its="http://www.w3.org/2005/11/its"

      xmlns:xi="http://www.w3.org/2001/XInclude"

      type="guide" style="task"

      id="buttonbox.py">

  <info>

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

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

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

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

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

    <credit type="author copyright">

      <name>Marta Maria Casetti</name>

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

      <years>2012</years>

    </credit>

    <desc>A container for arranging buttons</desc>

  </info>

  <title>ButtonBox</title>

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

  
A calculator - the buttons are enclosed in horizontal ButtonBoxes.

  <links type="section" />

  <section id="code">

    <title>Code used to generate this example</title>

    <xi:include href="samples/buttonbox.py" parse="text"><xi:fallback/></xi:include>

  </section>

  <section id="methods">

    <title>Useful methods for a ButtonBox widget</title>

    <list>

      <item>
The layout of the ButtonBox are set with set_layout(layout), where layout can be Gtk.ButtonBoxStyle.SPREAD (buttons are evenly spread across the box), Gtk.ButtonBoxStyle.EDGE (buttons are placed at the edges of the box), Gtk.ButtonBoxStyle.START (buttons are grouped towards the start of the box), Gtk.ButtonBoxStyle.END (buttons are grouped towards the end of the box), Gtk.ButtonBoxStyle.CENTER (buttons are centered in the box).
</item>

      <item>
set_child_secondary(button, is_secondary) sets whether button should appear in a secondary group of children. A typical use of a secondary child is the help button in a dialog. This group appears after the other children if the style is START, SPREAD or EDGE, and before the other children if the style is END. If the style is START or END, then the secondary children are aligned at the other end of the button box from the main children. For the other styles, they appear immediately next to the main children.
</item>

      <item>
set_child_non_homogeneous(button, is_non_homogeneous) sets whether the child is exempted from homogeneous sizing. Default value is False.
</item>

      <item>
set_spacing(spacing) sets the spacing, in pixels, between the buttons of the box.
</item>

    </list>

  </section>

  <section id="references">

    <title>API References</title>

    
In this sample we used the following:

    <list>

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

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

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

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

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

    </list>

  </section>

</page>