IupShow

IUP - Portable User Interface

IupShow

Displays a dialog in the current position, or changes a control VISIBLE attribute. If the dialog needs to be mapped and the current position is not known then the dialog is centered.

For a dialog to set the attribute VISIBLE=YES is the same as calling IupShow. For other controls, to call IupShow is the same as setting VISIBLE=YES.

Parameters/Return

int IupShow(Ihandle *ih); [in C]
iup.Show(ih: ihandle) -> (ret: number) [in Lua]
or ih:show() -> (ret: number) [in IupLua]

ih: identifier of the interface element.

This function returns IUP_NOERROR if sucessful. If there was an error returns IUP_ERROR.

Notes

For dialogs it is equivalent to IupShowXY using IUP_CURRENT (or IUP_CENTER if not mapped).

Will call IupMap for the element.

See the IupDialog PLACEMENT attribute for other position and show options.

This function can be executed more than once for the same dialog. This will make the dialog be placed above all other dialogs in the application, changing its Z-order, and update its position and/or size on screen. IMPORTANT: Calling IupShow for a visible dialog shown with IupPopup does nothing.

See Also

IupShowXY, IupHide, IupPopup, IupMap