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")