IUP/Layout/IupZbox

From Vendetta Lua
Revision as of 06:48, 9 May 2023 by Draugath (Talk | contribs) (Created page with "__NOTOC__ =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===...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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

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.

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)

See Also

IupHbox, IupVbox