Raise current dialog to the top

DESCRIPTION:

Raises the current dialog in the dialog handling system. This action should de-iconify the dialog, if necessary. It should also cause it to rise to the top of the windows on the display to make it visible.

Note: This function is deprecated. For more information, see .

USAGE:

dialog.popup(dialog=NULL) 

OPTIONAL ARGUMENTS:

dialog
an object of class dialog, as returned by the dialog.create function. A value of NULL causes the "current" dialog to be used.

SIDE EFFECTS:

The indicated dialog window should be unobscured after this call.

DETAILS:

This function ends up calling the Xlib routine XMapRaised(), which "marks a window as eligible for display." The window manager program in use may be involved in actually getting the window display (if, for instance, the window is currently iconified or in a different "room" or "workspace").

REFERENCES:

Nye, Adrian (ed) (1990). Xlib Reference Manual O'Reilly & Associates, Inc. Sebastopol, California USA

SEE ALSO:

, ,

EXAMPLES:

# Make sure dialog is displayed and unobscured. 
dialog.popup(lpr.dialog)