GtkHButtonBox

Name

GtkHButtonBox -- a container for arranging button horizontally.

Synopsis


#include <gtk/gtk.h>


struct      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);


Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBox
                           +----GtkButtonBox
                                 +----GtkHButtonBox

Description

A button box should be used to provide a consistent layout of buttons throughout your application. There is one default layout and a default spacing value that are persistant across all GtkHButtonBox widgets.

The layout/spacing can then 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 as any other box, using gtk_box_pack_start() or gtk_box_pack_end().

The default spacing between buttons can be set with gtk_hbutton_box_set_spacing_default() and queried with gtk_hbutton_box_get_spacing_default().

The arrangement and layout of the buttons can be changed using gtk_hbutton_box_set_layout_default() and queried with gtk_hbutton_box_get_layout_default().

Details

struct GtkHButtonBox

struct GtkHButtonBox;

button_box is the GtkHButtonBox widget itself and should not be modified directly.


gtk_hbutton_box_new ()

GtkWidget*  gtk_hbutton_box_new             (void);

Creates a new horizontal button box.


gtk_hbutton_box_get_spacing_default ()

gint        gtk_hbutton_box_get_spacing_default
                                            (void);

Warning

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.


gtk_hbutton_box_get_layout_default ()

GtkButtonBoxStyle gtk_hbutton_box_get_layout_default
                                            (void);

Warning

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.


gtk_hbutton_box_set_spacing_default ()

void        gtk_hbutton_box_set_spacing_default
                                            (gint spacing);

Warning

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.


gtk_hbutton_box_set_layout_default ()

void        gtk_hbutton_box_set_layout_default
                                            (GtkButtonBoxStyle layout);

Warning

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.

See Also

GtkBox

Used to pack widgets into button boxes.

GtkButtonBox

Provides functions for controlling button boxes.

GtkVButtonBox

Pack buttons vertically