GTK+ Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces |
#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 +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox +----GtkVButtonBox
GtkVButtonBox implements AtkImplementorIface, GtkBuildable and GtkOrientable.
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.
|
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.
|
a new GtkButtonBoxStyle. |