IUP/Layout/IupAppend

Inserts an interface element at the end of the container. Valid for hbox, vbox, or zbox.

Parameters/Return

iup.Append(box, element: ihandle) -> (box: ihandle)

box: Identifier of an hbox, vbox, or zbox.

element: Identifier of the element to be inserted in the box.

This function returns box if the interface element was successfully inserted. Otherwise, nil is returned.

Notes

This function can be used when the interface elements that will compose an hbox, vbox, or zbox are not known a priori and should be dynamically constructed.

For boxes, if the dialog is already mapped you must explicitly call IupMap after inserting a new element.

See Also

IupDetach, IupHbox, IupVbox, IupZbox.