| GTK+ Reference Manual |
|---|
GtkVButtonBoxGtkVButtonBox — A container for arranging buttons vertically |
#include <gtk/gtk.h>
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);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox +----GtkVButtonBox
A button box should be used to provide a consistent layout of buttons throughout your application. The layout/spacing can be altered by the programmer, or if desired, by the user to alter the 'feel' of a program to a small degree.
A GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are
packed into a button box the same way widgets are added to any other
container, using gtk_container_add(). You can also use
gtk_box_pack_start() or gtk_box_pack_end(), but for button boxes both
these functions work just like gtk_container_add(), ie., they pack the
button in a way that depends on the current layout style and on
whether the button has had gtk_button_box_set_child_secondary() called
on it.
The spacing between buttons can be set with gtk_box_set_spacing(). The
arrangement and layout of the buttons can be changed with
gtk_button_box_set_layout().
typedef struct _GtkVButtonBox GtkVButtonBox;
GtkVButtonBox does not contain any public fields.
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);
gtk_vbutton_box_get_spacing_default is deprecated and should not be used in newly-written code.
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);
gtk_vbutton_box_set_spacing_default is deprecated and should not be used in newly-written code.
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);
gtk_vbutton_box_get_layout_default is deprecated and should not be used in newly-written code.
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);
gtk_vbutton_box_set_layout_default is deprecated and should not be used in newly-written code.
Sets a new layout mode that will be used by all button boxes.
layout : |
a new GtkButtonBoxStyle. |
| GtkBox | Used to pack widgets into button boxes. |
| GtkButtonBox | Provides functions for controlling button boxes. |
| GtkHButtonBox | Pack buttons horizontally |
| << GtkHButtonBox | GtkFixed >> |