Set current dialog

DESCRIPTION:

Sets the current dialog to be the specified dialog in the dialog handling system.

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

USAGE:

dialog.setcurrent(dialog=NULL, stop.ok=T) 

OPTIONAL ARGUMENTS:

dialog
an object of class dialog, as returned by the dialog.create function. If NULL, the function verifies that there is a current dialog in the dialog handling system.
stop.ok
a logical flag controlling the behavior of the function. If set to T, this function uses stop to report an error message when the dialog is invalid for some reason. If set to F, then stop will not execute.

VALUE:

Returns a logical value that is T if the dialog setting operation (if requested) was successful and the current dialog is valid.

SIDE EFFECTS:

Alters the dialog that the dialog handling system considers to be the "current" dialog.

DETAILS:

Several of the standard dialog manipulation functions use this function to change the current dialog. This is where erroneous references to old dialogs are trapped. Such references can happen when a call to dialog.display is made using a dialog that has been destroyed or existed in a different invocation of the dialog handling system.

SEE ALSO:

, ,

EXAMPLES:

# Set current dialog to exiting dialog, then post it. 
dialog.setcurrent(lpr.dialog) 
dialog.send('dialog post', wait=T) 
# The "proper" way to do the above. 
dialog.popup(lpr.dialog)