| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
#include <gtk/gtk.h> struct GtkVButtonBox; GtkWidget* gtk_vbutton_box_new (void); gint gtk_vbutton_box_get_spacing_default (void); void gtk_vbutton_box_set_spacing_default (gint spacing); GtkButtonBoxStyle gtk_vbutton_box_get_layout_default (void); void gtk_vbutton_box_set_layout_default (GtkButtonBoxStyle layout); |
GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox +----GtkVButtonBox |
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.
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.
A VButtonBox is created with gtk_vbutton_box_new(). Buttons are packed into a button box the same way as any other box, using gtk_box_pack_start() or gtk_box_pack_end().
The default spacing between buttons can be set with gtk_vbutton_box_set_spacing_default() and queried with gtk_vbutton_box_get_spacing_default().
The arrangement and layout of the buttons can be changed using gtk_vbutton_box_set_layout_default() and queried with gtk_vbutton_box_get_layout_default().
GtkWidget* gtk_vbutton_box_new (void); |
Creates a new vertical button box.
| Returns : | a new button box GtkWidget. |
gint gtk_vbutton_box_get_spacing_default (void); |
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.
| Returns : | the default number of pixels between buttons. |
void gtk_vbutton_box_set_spacing_default
(gint spacing); |
Changes the default spacing that is placed between widgets in an vertical button box.
| spacing : | an integer value. |
GtkButtonBoxStyle gtk_vbutton_box_get_layout_default (void); |
Retrieves the current layout used to arrange buttons in button box widgets.
| Returns : | the current GtkButtonBoxStyle. |
void gtk_vbutton_box_set_layout_default
(GtkButtonBoxStyle layout); |
Sets a new layout mode that will be used by all button boxes.
| layout : | a new GtkButtonBoxStyle. |
Used to pack widgets into button boxes.
Provides functions for controlling button boxes.
Pack buttons horizontally.