<!-- ##### SECTION Title ##### -->GtkVButtonBox<!-- ##### SECTION Short_Description ##### -->A container for arranging buttons vertically<!-- ##### SECTION Long_Description ##### --><para>A button box should be used to provide a consistent layout of buttonsthroughout your application. The layout/spacing can be altered by theprogrammer, or if desired, by the user to alter the 'feel' of aprogram to a small degree.</para><para>A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons arepacked into a button box the same way widgets are added to any othercontainer, using gtk_container_add(). You can also usegtk_box_pack_start() or gtk_box_pack_end(), but for button boxes boththese functions work just like gtk_container_add(), ie., they pack thebutton in a way that depends on the current layout style and onwhether the button has had gtk_button_box_set_child_secondary() calledon it.</para><para>The spacing between buttons can be set with gtk_box_set_spacing(). Thearrangement and layout of the buttons can be changed withgtk_button_box_set_layout().</para><!-- ##### SECTION See_Also ##### --><para><variablelist><varlistentry><term>#GtkBox</term><listitem><para>Used to pack widgets into button boxes.</para></listitem></varlistentry><varlistentry><term>#GtkButtonBox</term><listitem><para>Provides functions for controlling button boxes.</para></listitem></varlistentry><varlistentry><term>#GtkHButtonBox</term><listitem><para>Pack buttons horizontally</para></listitem></varlistentry></variablelist></para><!-- ##### SECTION Stability_Level ##### --><!-- ##### STRUCT GtkVButtonBox ##### --><para>GtkVButtonBox does not contain any public fields.</para><!-- ##### FUNCTION gtk_vbutton_box_new ##### --><para>Creates a new vertical button box.</para>@Returns: a new button box #GtkWidget.<!-- ##### FUNCTION gtk_vbutton_box_get_spacing_default ##### --><para>Retrieves the current default spacing for vertical button boxes. This is the number of pixels to be placed between the buttons when they are arranged.</para>@Returns: the default number of pixels between buttons.<!-- ##### FUNCTION gtk_vbutton_box_set_spacing_default ##### --><para>Changes the default spacing that is placed between widgets in anvertical button box.</para>@spacing: an integer value.<!-- ##### FUNCTION gtk_vbutton_box_get_layout_default ##### --><para>Retrieves the current layout used to arrange buttons in button box widgets.</para>@Returns: the current #GtkButtonBoxStyle.<!-- ##### FUNCTION gtk_vbutton_box_set_layout_default ##### --><para>Sets a new layout mode that will be used by all button boxes.</para>@layout: a new #GtkButtonBoxStyle.