IupHbox

IUP - Portable User Interface

IupHbox

Creates an hbox container for composing elements. It is a box that arranges the elements it contains, horizontally and from left to right.

Creation

Ihandle* IupHbox(Ihandle *child, ...); [in C]
Ihandle* IupHboxv(Ihandle **children); [in C]
iup.hbox{child, ...: ihandle} -> (elem: ihandle) [in Lua]
hbox(child, ...) [in LED]

child,... : List of identifiers that will be placed in the box. NULL must be used to define the end of the list in C. It can be empty.

Returns: the identifier of the created element, or NULL if an error occurs.

Attributes

ALIGNMENT (non inheritable): Aligns the elements vertically. Possible values: "ATOP", "ACENTER", "ABOTTOM". Default: "ATOP".

EXPAND: The default value is "YES".

GAP: Defines a space in pixels between the interface elements. Default: "0".

MARGIN: Defines a margin in pixels. Its value has the format "widthxheight", where width and height are integer values corresponding to the horizontal and vertical margins, respectively. Default: "0x0" (no margin).

SIZE / RASTERSIZE (non inheritable): Defines the width of the box. When consulted behaves as the standard SIZE/RASTERSIZE attributes. SIZE uses the FONT attribute of the native parent to convert to pixels.

WID (read-only): returns NULL.


CLIENTSIZE, X, Y, POSITION: also accepted.

Notes

The box can be created with no elements and be dynamic filled using IupAppend.

Examples

Browse Example Files

iuphbox.gif (7213 bytes)

See Also

IupZbox, IupVBox