|
|
| 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]]
| + | |
