Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkhbbox.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkHButtonBox
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 A container for arranging buttons horizontally
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 A button box should be used to provide a consistent layout of buttons
  10 throughout your application. The layout/spacing can be altered by the
  11 programmer, or if desired, by the user to alter the 'feel' of a
  12 program to a small degree.
  13 </para>
  14 <para>
  15 A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are
  16 packed into a button box the same way widgets are added to any other
  17 container, using gtk_container_add(). You can also use
  18 gtk_box_pack_start() or gtk_box_pack_end(), but for button boxes both
  19 these functions work just like gtk_container_add(), ie., they pack the
  20 button in a way that depends on the current layout style and on
  21 whether the button has had gtk_button_box_set_child_secondary() called
  22 on it.
  23 </para>
  24
  25 <para>
  26 The spacing between buttons can be set with gtk_box_set_spacing(). The
  27 arrangement and layout of the buttons can be changed with
  28 gtk_button_box_set_layout().
  29 </para>
  30
  31 <!-- ##### SECTION See_Also ##### -->
  32 <para>
  33 <variablelist>
  34 <varlistentry>
  35 <term>#GtkBox</term>
  36 <listitem><para>Used to pack widgets into button boxes.</para></listitem>
  37 </varlistentry><varlistentry>
  38 <term>#GtkButtonBox</term>
  39 <listitem><para>Provides functions for controlling button boxes.</para></listitem>
  40 </varlistentry>
  41 <varlistentry>
  42 <term>#GtkVButtonBox</term>
  43 <listitem><para>Pack buttons vertically</para></listitem>
  44 </varlistentry>
  45 </variablelist>
  46 </para>
  47
  48 <!-- ##### SECTION Stability_Level ##### -->
  49
  50
  51 <!-- ##### SECTION Image ##### -->
  52
  53
  54 <!-- ##### STRUCT GtkHButtonBox ##### -->
  55 <para>
  56 GtkHButtonBox does not contain any public fields.
  57 </para>
  58
  59
  60 <!-- ##### FUNCTION gtk_hbutton_box_new ##### -->
  61 <para>
  62 Creates a new horizontal button box.
  63 </para>
  64
  65 @void:
  66 @Returns: a new button box #GtkWidget.
  67
  68