IupAppend

IUP - Portable User Interface

IupAppend

Inserts an interface element at the end of the container. Valid for any element that contains other elements like hbox, vbox, zbox or menu.

Parameters/Return

Ihandle* IupAppend(Ihandle* ih, Ihandle* child); [in C]
iup.Append(ih, child: ihandle) -> (box: ihandle) [in Lua]

ih: Identifier of a container like hbox, vbox, zbox and menu.
child: Identifier of the element to be inserted.

This function returns ih if the interface element was successfully inserted. Otherwise returns NULL (nil in Lua).

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 container is already mapped you must explicitly call IupMap for the child.

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.