IupDestroy

IUP - Portable User Interface

IupDestroy

Destroys an interface element and all of its descendants.

Parameters/Return

void IupDestroy(Ihandle *element); [in C]
IupDestroy(element: iuplua_tag) [in IupLua3]
iup.Destroy(element: iuplua_tag) [in IupLua5]
or element:destroy() [in IupLua]

element: Identifier of the interface element to be destroyed.

Notes

This function deletes the names associated to the interface elements being destroyed. It does not free the memory of attribute values that was allocated by the application.

ATTENTION: The interface elements associated by means of attributes (such as menus in dialogs and images in buttons) are not destroyed. The application will be in charge of such task.