IupDestroy
Destroys an interface element and all of its descendants. Only dialogs, timers, popup menus and images should be normally destroyed, but detached controls can also be destroyed.
Parameters/Return
void IupDestroy(Ihandle *element); [in C] iup.Destroy(element: ihandle) [in Lua] or element:destroy() [in Lua]
element: Identifier of the interface element to be destroyed.
Notes
Elements attached to the dialog or menu can not be destroyed, must be detached first.
This function deletes also the names associated to the interface elements being destroyed.
Menu bars associated with dialogs are automatically destroyed. Images associated with controls are not destroyed, because images can be reused in several controls the application must destroy them when they are not used anymore.