IupZbox

IUP - Portable User Interface

IupZbox

Creates a zbox container for composing elements. It is a box that piles up the elements it contains, only the active element is visible.

Creation

Ihandle* IupZbox (Ihandle *child, ...); [in C]
Ihandle* IupZboxv (Ihandle **children); [in C]
iup.zbox{child, ... : ihandle} -> (elem: ihandle) [in Lua]
zbox(child, ...) [in LED]

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

IMPORTANT: in C, each element must have a name defined by IupSetHandle. In Lua a name is always automatically created, but you can change it later.

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

Attributes

ALIGNMENT: Defines the alignment of the active element. Possible values:

"NORTH", "SOUTH", "WEST", "EAST",
"NE", "SE", "NW", "SW",
"ACENTER".

Default: "NE".

MARGIN: Defines the margin of the visible element. 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).

VALUE: Changes the active element. The value passed must be the name of one of the elements contained in the zbox. Default: the first element. To set the name of an element, use the IupSetHandle function. In Lua you can also use the element reference directly.

SIZE: Defines the zbox size. Default: the smallest size that fits its largest element.

EXPAND: The default value is "YES".

Notes

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

Though this element can have attributes ALIGNMENT and MARGIN, it does not have attribute GAP.

Examples

Browse Example Files

iupzbox.gif

See Also

IupHbox, IupVBox