GTK+ Reference Manual | ||||
---|---|---|---|---|
#include <gtk/gtk.h> GtkHButtonBox; GtkWidget* gtk_hbutton_box_new (void); gint gtk_hbutton_box_get_spacing_default (void); GtkButtonBoxStyle gtk_hbutton_box_get_layout_default (void); void gtk_hbutton_box_set_spacing_default (gint spacing); void gtk_hbutton_box_set_layout_default (GtkButtonBoxStyle layout);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox +----GtkHButtonBox
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 GtkHButtonBox is created with gtk_hbutton_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 _GtkHButtonBox GtkHButtonBox;
GtkHButtonBox does not contain any public fields.
GtkWidget* gtk_hbutton_box_new (void);
Creates a new horizontal button box.
Returns : | a new button box GtkWidget. |
gint gtk_hbutton_box_get_spacing_default (void);
gtk_hbutton_box_get_spacing_default
is deprecated and should not be used in newly-written code.
Retrieves the current default spacing for horizontal 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. |
GtkButtonBoxStyle gtk_hbutton_box_get_layout_default (void);
gtk_hbutton_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_hbutton_box_set_spacing_default (gint spacing);
gtk_hbutton_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 horizontal button box.
spacing : |
an integer value. |
void gtk_hbutton_box_set_layout_default (GtkButtonBoxStyle layout);
gtk_hbutton_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. |
GtkVButtonBox | Pack buttons vertically |