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 HButtonBox is created with hButtonBoxNew. Buttons are packed into a button box the same way widgets are added to any other container, using containerAdd. You can also use boxPackStart or boxPackEnd, but for button boxes both these functions work just like containerAdd, ie., they pack the button in a way that depends on the current layout style and on whether the button has had buttonBoxSetChildSecondary called on it.

The spacing between buttons can be set with boxSetSpacing. The arrangement and layout of the buttons can be changed with buttonBoxSetLayout.

 |  GObject
 |   +----Object
 |         +----Widget
 |               +----Container
 |                     +----Box
 |                           +----ButtonBox
 |                                 +----HButtonBox