Vendetta/helium/api/iup prepend

Intended to behave like iup.Append(), but the child is put before instead of after other children.

Definition

helium.util.iup_prepend(root_ihandle, child_ihandle) -> nil

Arguments

root_ihandle: type *iup_object: dialog or other iup element item to add the child into. child_ihandle: type *iup_object: iup element item to be inserted at top of the root object's stack.

Notes

In order to insert elements, this function iterates and detaches all existing items before adding the new element, and then re-attaches all the other elements in order. As such, extremely large iup structures may be expensive to insert items into; if inserting elements into a long list of items, consider using the asynchronous version of this function to retain client functionality.