IupAppend
Inserts an interface element at the end of the container. Valid for any element that contains other elements like dialog, frame, hbox, vbox, zbox or menu.
It will NOT map the element into the native system.
Parameters/Return
Ihandle* IupAppend(Ihandle* parent, Ihandle* ih); [in C] iup.Append(parent, ih: ihandle) -> (parent: ihandle) [in Lua]
parent: Identifier of a container like hbox, vbox, zbox and menu.
ih: Identifier of the element to be inserted.
This function returns the actual parent if the interface element was successfully inserted. Otherwise returns NULL (nil in Lua). Notice that the desired parent can contains a set of elements and containers where the child will be actually attached so the function returns the actual parent of the element.
Notes
This function can be used when elements that will compose a container are not known a priori and should be dynamically constructed.
If the parent is already mapped you must explicitly call IupMap for the appended children or for the main container.
The elements are NOT immediately repositioned. Call IupRefresh for the container* to update the dialog layout (* or any other element in the dialog).
See Also
IupDetach, IupHbox, IupVbox, IupZbox, IupMenu, IupMap, IupUnmap, IupRefresh