<HTML ><HEAD ><TITLE >GtkVButtonBox</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.61 "><LINK REL="HOME" TITLE="GTK+ Reference Manual" HREF="index.html"><LINK REL="UP" TITLE="GTK+ Widgets and Objects" HREF="gtkobjects.html"><LINK REL="PREVIOUS" TITLE="GtkTreeItem" HREF="gtktreeitem.html"><LINK REL="NEXT" TITLE="GtkVBox" HREF="gtkvbox.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TH COLSPAN="4" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="5" >GTK+ Reference Manual</FONT ></TH ></TR ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gtktreeitem.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="index.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="gtkobjects.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gtkvbox.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GTKVBUTTONBOX" >GtkVButtonBox</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN43748" ></A ><H2 >Name</H2 >GtkVButtonBox -- a container for arranging buttons vertically.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN43751" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gtk/gtk.h> struct <A HREF="gtkvbuttonbox.html#GTKVBUTTONBOX-STRUCT" >GtkVButtonBox</A >; <A HREF="gtkwidget.html" >GtkWidget</A >* <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-NEW" >gtk_vbutton_box_new</A > (void); <A HREF=../glib/glib-basic-types.html#GINT >gint</A> <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-GET-SPACING-DEFAULT" >gtk_vbutton_box_get_spacing_default</A > (void); void <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-SET-SPACING-DEFAULT" >gtk_vbutton_box_set_spacing_default</A > (<A HREF=../glib/glib-basic-types.html#GINT >gint</A> spacing); <A HREF="gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE" >GtkButtonBoxStyle</A > <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-GET-LAYOUT-DEFAULT" >gtk_vbutton_box_get_layout_default</A > (void); void <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-SET-LAYOUT-DEFAULT" >gtk_vbutton_box_set_layout_default</A > (<A HREF="gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE" >GtkButtonBoxStyle</A > layout); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN43765" ></A ><H2 >Object Hierarchy</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > <A HREF="gtkobject.html" >GtkObject</A > +----<A HREF="gtkwidget.html" >GtkWidget</A > +----<A HREF="gtkcontainer.html" >GtkContainer</A > +----<A HREF="gtkbox.html" >GtkBox</A > +----<A HREF="gtkbuttonbox.html" >GtkButtonBox</A > +----GtkVButtonBox</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN43773" ></A ><H2 >Description</H2 ><P >A button box should be used to provide a consistent layout of buttons throughout your application. There is one default layout and a default spacing value that are persistant across all VButtonBox widgets.</P ><P >The layout/spacing can then be altered by the programmer, or if desired, by the user to alter the 'feel' of a program to a small degree.</P ><P >A VButtonBox is created with <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-NEW" >gtk_vbutton_box_new</A >(). Buttons are packed into a button box the same way as any other box, using <A HREF="gtkbox.html#GTK-BOX-PACK-START" >gtk_box_pack_start</A >() or <A HREF="gtkbox.html#GTK-BOX-PACK-END" >gtk_box_pack_end</A >().</P ><P >The default spacing between buttons can be set with <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-SET-SPACING-DEFAULT" >gtk_vbutton_box_set_spacing_default</A >() and queried with <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-GET-SPACING-DEFAULT" >gtk_vbutton_box_get_spacing_default</A >().</P ><P >The arrangement and layout of the buttons can be changed using <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-SET-LAYOUT-DEFAULT" >gtk_vbutton_box_set_layout_default</A >() and queried with <A HREF="gtkvbuttonbox.html#GTK-VBUTTON-BOX-GET-LAYOUT-DEFAULT" >gtk_vbutton_box_get_layout_default</A >().</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN43789" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN43791" ></A ><H3 ><A NAME="GTKVBUTTONBOX-STRUCT" ></A >struct GtkVButtonBox</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >struct GtkVButtonBox;</PRE ></TD ></TR ></TABLE ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN43796" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFF0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN43801" ></A ><H3 ><A NAME="GTK-VBUTTON-BOX-NEW" ></A >gtk_vbutton_box_new ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><A HREF="gtkwidget.html" >GtkWidget</A >* gtk_vbutton_box_new (void);</PRE ></TD ></TR ></TABLE ><P >Creates a new vertical button box.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN43807" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><I CLASS="EMPHASIS" >Returns</I > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a new button box <A HREF="gtkwidget.html" >GtkWidget</A >. </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN43817" ></A ><H3 ><A NAME="GTK-VBUTTON-BOX-GET-SPACING-DEFAULT" ></A >gtk_vbutton_box_get_spacing_default ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><A HREF=../glib/glib-basic-types.html#GINT >gint</A> gtk_vbutton_box_get_spacing_default (void);</PRE ></TD ></TR ></TABLE ><P >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.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN43823" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><I CLASS="EMPHASIS" >Returns</I > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >the default number of pixels between buttons. </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN43832" ></A ><H3 ><A NAME="GTK-VBUTTON-BOX-SET-SPACING-DEFAULT" ></A >gtk_vbutton_box_set_spacing_default ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gtk_vbutton_box_set_spacing_default (<A HREF=../glib/glib-basic-types.html#GINT >gint</A> spacing);</PRE ></TD ></TR ></TABLE ><P >Changes the default spacing that is placed between widgets in an vertical button box.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN43838" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >spacing</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >an integer value. </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN43847" ></A ><H3 ><A NAME="GTK-VBUTTON-BOX-GET-LAYOUT-DEFAULT" ></A >gtk_vbutton_box_get_layout_default ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><A HREF="gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE" >GtkButtonBoxStyle</A > gtk_vbutton_box_get_layout_default (void);</PRE ></TD ></TR ></TABLE ><P >Retrieves the current layout used to arrange buttons in button box widgets.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN43853" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><I CLASS="EMPHASIS" >Returns</I > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >the current <A HREF="gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE" >GtkButtonBoxStyle</A >. </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN43863" ></A ><H3 ><A NAME="GTK-VBUTTON-BOX-SET-LAYOUT-DEFAULT" ></A >gtk_vbutton_box_set_layout_default ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gtk_vbutton_box_set_layout_default (<A HREF="gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE" >GtkButtonBoxStyle</A > layout);</PRE ></TD ></TR ></TABLE ><P >Sets a new layout mode that will be used by all button boxes.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN43869" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >layout</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a new <A HREF="gtk-standard-enumerations.html#GTKBUTTONBOXSTYLE" >GtkButtonBoxStyle</A >.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN43879" ></A ><H2 >See Also</H2 ><P ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><A HREF="gtkbox.html" >GtkBox</A ></DT ><DD ><P >Used to pack widgets into button boxes.</P ></DD ><DT ><A HREF="gtkbuttonbox.html" >GtkButtonBox</A ></DT ><DD ><P >Provides functions for controlling button boxes.</P ></DD ><DT ><A HREF="gtkhbuttonbox.html" >GtkHButtonBox</A ></DT ><DD ><P >Pack buttons horizontally.</P ></DD ></DL ></DIV ></P ></DIV ><DIV CLASS="NAVFOOTER" ><BR CLEAR="all"><BR><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gtktreeitem.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="index.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="gtkobjects.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gtkvbox.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GtkTreeItem</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >GtkVBox</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >