NAME

AG_HBox —

agar horizontal container widget

SYNOPSIS

#include <agar/core.h>
#include <agar/gui.h>

DESCRIPTION

The AG_HBox widget is a variant of AG_Box(3) which packs its children horizontally.

INHERITANCE HIERARCHY

AG_Object(3) -> AG_Widget(3) -> AG_Box(3) -> AG_HBox.

INITIALIZATION

AG_HBox *
AG_HBoxNew(AG_Widget *parent, int flags);

void
AG_HBoxSetHomogenous(AG_HBox *box, int homogenous);

void
AG_HBoxSetPadding(AG_HBox *box, int padding);

void
AG_HBoxSetSpacing(AG_Box *hbox, int spacing);

The AG_HBoxNew() function allocates, initializes, and attaches a new AG_HBox widget. Acceptable flags include:

AG_HBOX_HFILL: Expand horizontally in parent (equivalent to invoking AG_ExpandHoriz(3)).
AG_HBOX_VFILL: Expand vertically in parent (equivalent to invoking AG_ExpandVert(3)).
AG_HBOX_EXPAND: Shorthand for AG_HBOX_HFILL|AG_HBOX_VFILL.

The AG_HBoxSetHomogenous() function defines whether avialable space is divided evenly between attached widgets.

The AG_HBoxSetPadding() function sets the padding around the group of child widgets to padding pixels. AG_HBoxSetSpacing() sets the spacing between individual child widgets to spacing pixels.

EVENTS

The AG_HBox widget does not generate any event.

HISTORY

The AG_HBox widget first appeared in Agar 1.0.