IUP/Controls/IupZbox
From Vendetta Lua
Jump to navigationJump to search
Controls |
Dialog |
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
iup.zbox{elem1, elem2, ... : ihandle} -> (elem: ihandle)
- elem1, elem2, ...: List of the elements that will be placed in the box. NULL defines the end of the list in C.
- This function returns the identifier of the created zbox, or nil 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.
- ALL: Displays all elements in the Zbox. Possible values: "YES", "NO"
Note
- The box can be created with no elements and be dynamic filled using IupAppend.
- Though this element can have attributes ALIGNMENT and MARGIN, it does not have attribute GAP.
Examples
iupzbox.gif (4205 bytes)