| 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 |
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.
| b : | |
| Returns : | the current spacing applied to the buttons in widget. |
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.
| b : | |
| s : |
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 : | |
| child : | a child of widget |
| is_secondary : | if TRUE, the child appears in a secondary group of the button box. |
| "layout-style" (GtkButtonBoxStyle : Read / Write) | How to layout the buttons in the box. Possible values are default, spread, edge, start and end. |
| "secondary" (gboolean : Read / Write) | If TRUE, the child appears in a secondary group of children, suitable for, e.g., help buttons. |
| GtkVButtonBox | Vertical sub-class of GtkButtonBox. |
| GtkHButtonBox | Horizontal sub-class of GtkButtonBox. |