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.
This function returns the identifier of the created zbox, or NULL (nil in Lua) 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.
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
