IupVbox

IUP - Portable User Interface

IupVbox

Creates a vbox container for composing elements. It is a box that arranges the elements it contains, vertically and from the top down.

Creation

Ihandle* IupVbox(Ihandle *child, ...); [in C]
Ihandle* IupVboxv(Ihandle **children); [in C]
iup.vbox{child, ...: ihandle} -> (elem: ihandle) [in Lua]
vbox(child, ...) [in LED]

child, ... : List of the 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): Horizontally aligns the elements. Possible values: "ALEFT", "ACENTER", "ARIGHT". Default: "ALEFT".

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 height 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

iupvbox.gif (7671  bytes)

See Also

IupZbox, IupHbox