IupShowXY

Displays a dialog in a given position on the screen.

Parameters/Return

int IupShowXY(Ihandle *ih, int x, int y); [in C]
iup.ShowXY(ih: ihandle[, x, y: number]) -> (ret: number) [in Lua]
or ih:showxy([x, y: number]) -> (ret: number) [in Lua]

ih: identifier of the dialog.
x: horizontal position of the dialog relative to the origin of the screen. The following macros are valid:

y: vertical position of the dialog relative to the origin of the screen. The following macros are valid:

Returns: IUP_NOERROR if sucessful. Returns IUP_INVALID if not a dialog.  If there was an error returns IUP_ERROR.

Notes

Will call IupMap for the element.

See the PLACEMENT attribute for other position and show options.

When IUP_CENTERPARENT is used but PARENTDIALOG is not defined then it is replaced by IUP_CENTER.

When IUP_CURRENT is used at the first time the dialog is shown then it will be replaced by IUP_CENTERPARENT.

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 IupShowXY for a visible dialog shown with IupPopup does nothing.

See Also

IupShow, IupHide, IupPopup, IupMap