IupDestroy

IUP - Portable User Interface

IupDestroy

Destroys an interface element and all of its descendants. Only dialogs, timers, popup menus and images can be destroyed.

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 also the names associated to the interface elements being destroyed. It does not free the memory of attribute values that was allocated by the application.

Menu bars associated with dialogs are automatically destroyed. Images associated with controls are not destroyed, the application is in charge of such task.