IupAppend

Definition: include pGUI.e

IupAppend(Ihandle ih, Ihandle new_child)
Description: Inserts an interface element at the end of the container, after the last element of the container.
Valid for any element that contains other elements like dialog, frame, hbox, vbox, zbox or menu.

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

A fatal error occurs if the element could not be successfully inserted.
Notes: This function can be used when elements that will compose a container are not known a priori and should be dynamically constructed.

The new child can NOT be mapped. It will NOT map the new child into the native system.
If the parent is already mapped you must explicitly call IupMap for the appended child.

If the actual parent is a layout box (IupVbox, IupHbox or IupZbox) and you try to append a child that it is already at the parent child list, then the child is moved to the last child position.

The elements are NOT immediately repositioned. Call IupRefresh for the container (or any other element in the dialog) to update the dialog layout.
See Also: IupDetach, IupInsert, IupHbox, IupVbox, IupZbox, IupMenu, IupMap, IupUnmap, IupRefresh