|
|
| Line 1: |
Line 1: |
| __NOTOC__
| | #REDIRECT [[IUP/Controls/Zbox]] |
| =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.
| |
| | |
| :'''[[IUP/Attributes/Common/SIZE|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 [[IUP/Layout/IupAppend|IupAppend]].
| |
| | |
| :Though this element can have attributes ALIGNMENT and MARGIN, it does not have attribute GAP.
| |
| | |
| ===Examples===
| |
| | |
| iupzbox.gif (4205 bytes)
| |
| ===See Also===
| |
| | |
| :[[IUP/Layout/IupHbox|IupHbox]], [[IUP/Layout/IupVbox|IupVbox]]
| |
