| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
#include <gtk/gtk.h> struct GtkButtonBox; #define GTK_BUTTONBOX_DEFAULT #define gtk_button_box_get_spacing (b) GtkButtonBoxStyle gtk_button_box_get_layout (GtkButtonBox *widget); void gtk_button_box_get_child_size (GtkButtonBox *widget, gint *min_width, gint *min_height); void gtk_button_box_get_child_ipadding (GtkButtonBox *widget, gint *ipad_x, gint *ipad_y); #define gtk_button_box_set_spacing (b,s) void gtk_button_box_set_layout (GtkButtonBox *widget, GtkButtonBoxStyle layout_style); void gtk_button_box_set_child_size (GtkButtonBox *widget, gint min_width, gint min_height); void gtk_button_box_set_child_ipadding (GtkButtonBox *widget, gint ipad_x, gint ipad_y); void gtk_button_box_set_child_secondary (GtkButtonBox *widget, GtkWidget *child, gboolean is_secondary); |
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox |
"child-min-width" gint : Read "child-min-height" gint : Read "child-internal-pad-y" gint : Read "child-internal-pad-x" gint : Read |
The primary purpose of this class is to keep track of the various properties of GtkHButtonBox and GtkVButtonBox widgets.
gtk_button_box_get_child_size() retrieves the minimum width and height for widgets in a given button box. gtk_button_box_set_child_size() allows those properties to be changed.
The internal padding of buttons can be retrieved and changed per button box using gtk_button_box_get_child_ipadding() and gtk_button_box_set_child_ipadding() respectively.
gtk_button_box_get_spacing() and gtk_button_box_set_spacing() retrieve and change default number of pixels between buttons, respectively.
gtk_button_box_get_layout() and gtk_button_box_set_layout() retrieve and alter the method used to spread the buttons in a button box across the container, respectively.
struct GtkButtonBox; |
This is a read-only struct; no members should be modified directly.
#define gtk_button_box_get_spacing(b) gtk_box_get_spacing (GTK_BOX (b)) |
| Warning |
gtk_button_box_get_spacing is deprecated and should not be used in newly-written code. |
Retrieves how much space a button box is placing between each child button.
GtkButtonBoxStyle gtk_button_box_get_layout (GtkButtonBox *widget); |
Retrieves the method being used to arrange the buttons in a button box.
| widget : | a GtkButtonBox. |
| Returns : | the method used to layout buttons in widget. |
void gtk_button_box_get_child_size (GtkButtonBox *widget, gint *min_width, gint *min_height); |
| Warning |
gtk_button_box_get_child_size is deprecated and should not be used in newly-written code. |
Retrieves the current width and height of all child widgets in a button box. min_width and min_height are filled with those values, respectively.
| widget : | a GtkButtonBox. |
| min_width : | the width of the buttons contained by widget. |
| min_height : | the height of the buttons contained by widget. |
void gtk_button_box_get_child_ipadding
(GtkButtonBox *widget,
gint *ipad_x,
gint *ipad_y); |
| Warning |
gtk_button_box_get_child_ipadding is deprecated and should not be used in newly-written code. |
Gets the default number of pixels that pad the buttons in a given button box.
| widget : | a GtkButtonBox. |
| ipad_x : | the horizontal padding used by buttons in widget. |
| ipad_y : | the vertical padding used by buttons in widget. |
#define gtk_button_box_set_spacing(b,s) gtk_box_set_spacing (GTK_BOX (b), s) |
| Warning |
gtk_button_box_set_spacing is deprecated and should not be used in newly-written code. |
Sets the amount of spacing between buttons in a given button box.
void gtk_button_box_set_layout (GtkButtonBox *widget, GtkButtonBoxStyle layout_style); |
Changes the way buttons are arranged in their container.
| widget : | a GtkButtonBox. |
| layout_style : | the new layout style. |
void gtk_button_box_set_child_size (GtkButtonBox *widget, gint min_width, gint min_height); |
| Warning |
gtk_button_box_set_child_size is deprecated and should not be used in newly-written code. |
Sets a new default size for the children of a given button box.
| widget : | a GtkButtonBox. |
| min_width : | a default width for buttons in widget. |
| min_height : | a default height for buttons in widget. |
void gtk_button_box_set_child_ipadding
(GtkButtonBox *widget,
gint ipad_x,
gint ipad_y); |
| Warning |
gtk_button_box_set_child_ipadding is deprecated and should not be used in newly-written code. |
Changes the amount of internal padding used by all buttons in a given button box.
| widget : | a GtkButtonBox. |
| ipad_x : | the horizontal padding that should be used by each button in widget. |
| ipad_y : | the vertical padding that should be used by each button in widget. |
void gtk_button_box_set_child_secondary
(GtkButtonBox *widget,
GtkWidget *child,
gboolean is_secondary); |
Sets whether child should appear in a secondary group of children. A typical use of a secondary child is the help button in a dialog.
This group appears after the other children if the style is GTK_BUTTONBOX_START, GTK_BUTTONBOX_SPREAD or GTK_BUTTONBOX_EDGE, and before the the other children if the style is GTK_BUTTONBOX_END. For horizontal button boxes, the definition of before/after depends on direction of the widget (see gtk_widget_set_direction()). If the style is GTK_BUTTONBOX_START or GTK_BUTTONBOX_END, then the secondary children are aligned at the other end of the button box from the main children. For the other styles, they appear immediately next to the main children.
| widget : | a GtkButtonBox |
| child : | a child of widget |
| is_secondary : | if TRUE, the child appears in a secondary group of the button box. |
How to layout the buttons in the box. Possible values are default, spread, edge, start and end
If TRUE, the child appears in a secondary group of children, suitable for, e.g., help buttons.
Minimum width of buttons inside the box
Minimum height of buttons inside the box
Amount to increase child's size on the top and bottom
Amount to increase child's size on either side
Vertical sub-class of GtkButtonBox.
Horizontal sub-class of GtkButtonBox.