## GtkHButtonBox

GtkHButtonBox — A container for arranging buttons horizontally

## Synopsis

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

## Object Hierarchy

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

## Implemented Interfaces

GtkHButtonBox implements AtkImplementorIface and GtkBuildable.

## Description

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()`.

## Details

### GtkHButtonBox

    typedef struct _GtkHButtonBox GtkHButtonBox;

GtkHButtonBox does not contain any public fields.

### gtk_hbutton_box_new ()

    GtkWidget*          gtk_hbutton_box_new                 (void);

Creates a new horizontal button box.

Returns : | a new button box GtkWidget.

### 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.

Returns : | the default number of pixels between buttons.

### 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.

Returns : | the current GtkButtonBoxStyle.

### 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.

`spacing` : | an integer value.

### 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.

`layout` : | a new GtkButtonBoxStyle.

## See Also

GtkBox | Used to pack widgets into button boxes.
GtkButtonBox | Provides functions for controlling button boxes.
GtkVButtonBox | Pack buttons vertically