IupElementPropertiesDialog (since 3.5)

Creates an Element Properties Dialog. It is a predefined dialog to edit the properties of an element in run time. It is a standard IupDialog constructed with other IUP elements. The dialog can be shown with any of the show functions IupShow, IupShowXY or IupPopup.

Any existent element can be edited. It does not need to be mapped on the native system nor visible. It could have been created in any language.

This is a dialog intended for developers, so they can see and inspect their elements in other ways.

It contains 3 Tab sections: one for the registered attributes of the element, one for custom attributes set by the application, and one for the callbacks. The callbacks are just for inspection, and custom attributes should be handled carefully because they may be not strings. Registered attributes values are shown in red when they were changed by the application.


Ihandle* IupElementPropertiesDialog(Ihandle* parent, Ihandle* elem); [in C]
iup.ElementPropertiesDialog(parent, elem: ihandle) -> (dlg: ihandle) [in Lua]
[NOT available in LED]
parent: dialog to be used as parent for the properties dialog. Can be NULL. (since 3.28)
: identifier of the element to display the properties. Not optional.

Returns: the identifier of the created dialog, or NULL if an error occurs.


Check the IupDialog attributes.


Check the IupDialog callbacks.

ATTRIBCHANGED_CB: Called when an attribute is changed. (since 3.28)

int function(Ihandle *ih, char* name); [in C]
elem:attribchanged_cb(name: string) -> (ret: number) [in Lua]

ih: identifier of the element that activated the event.
name: name of the attribute that changed.


IupShow(IupElementPropertiesDialog(button));   [in C]

iup.Show(iup.ElementPropertiesDialog(button))    [in Lua]

The dialog is displayed next.

See Also

IupDialog, IupShow, IupShowXY, IupPopup, IupLayoutDialog