Display a dialog

DESCRIPTION:

Displays (pops up) a dialog, waits for a button to be pressed, then causes the display to disappear.

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

USAGE:

dialog.display(dialog, popdown=T) 

REQUIRED ARGUMENTS:

dialog
an object of class dialog, as returned by the dialog.create function.

OPTIONAL ARGUMENTS:

popdown
a logical value to control the display of the dialog after a button is pressed. If TRUE, the dialog is "popped down" or no longer displayed. If FALSE, it remains displayed.

VALUE:

Returns a list with two components. The "button" component is set to the character string label of the button that was pressed (as returned by the dialog.getbutton function). The "values" component is set to the list of current values (as returned by the dialog.getvalues function). This list is similar in structure to the list used as the values argument to the original dialog.create call. Refer to the dialog.create help file for more information about what the differences could be between the initial values list and the returned list.

SIDE EFFECTS:

Causes a dialog to display. This function causes S-PLUS execution to stop until the user presses one of the dialog buttons.

SEE ALSO:

, , , ,

EXAMPLES:

# Ask user for a print command 
dialog1 <- dialog.create (list("Print command"="lpr")) 
answer1 <- dialog.display (dialog1) 
if(answer1$button == "OK") 
   ps.options (command=answer1$values$"Print command")