DIALOG_MESSAGE

The DIALOG_MESSAGE function creates a modal (blocking) dialog box that can be used to display information for the user. The dialog must be dismissed, by clicking on one of its option buttons, before execution of the widget program can continue.

This function differs from widgets in a number of ways. The DIALOG_MESSAGE dialog does not exist as part of a widget tree, has no children, does not exist in an unrealized state, and generates no events. Instead, the dialog is displayed whenever this function is called. While the DIALOG_MESSAGE dialog is displayed, widget activity is limited because the dialog is modal. The function does not return to its caller until the user selects one of the dialog's buttons. Once a button has been selected, the dialog disappears.

DIALOG_MESSAGE returns a string containing the text of the label that the user selected.

There are four basic dialogs that can be displayed. The default type is "Warning". Other types can be selected by setting one of the keywords described below. Each dialog type displays different buttons. Additionally any dialog can be made to show a "Cancel" button by setting the CANCEL keyword. The four types of dialogs are described in the table below:

Types of DIALOG_MESSAGE Dialogs
Dialog Type	Default Buttons
Error	OK
Warning	OK
Question	Yes, No
Information	OK

Keywords

CANCEL

Set this keyword to add a "Cancel" button to the dialog.

DEFAULT_CANCEL

Set this keyword to make the "Cancel" button the default selection for the dialog. The default selection is the button that is selected when the user presses the default keystroke (usually Space or Return depending on the platform). Setting DEFAULT_CANCEL implies that the CANCEL keyword is also set.

DEFAULT_NO

Set this keyword to make the "No" button the default selection for "Question" dialogs. Normally, the default is "Yes".

DIALOG_PARENT

Set this keyword to the widget ID of a widget over which the message dialog should be positioned. When displayed, the DIALOG_MESSAGE dialog will be positioned over the specified widget. Dialogs are often related to a non-dialog widget tree. The ID of the widget in that tree to which the dialog is most closely related should be specified.

NOTE: In IDL for Windows the message dialog is centered on the screen rather than positioned over the specified widget.

This keyword is ignored on Macintosh platforms.

DISPLAY_NAME

Set this keyword equal to a string indicating the name of the X Windows display on which the dialog is to appear. This keyword is ignored if the DIALOG_PARENT keyword is specified. This keyword is also ignored on Microsoft Windows and Macintosh platforms.

ERROR

Set this keyword to create an "Error" dialog. The default dialog type is "Warning".

INFORMATION

Set this keyword to create an "Information" dialog. The default dialog type is "Warning".

QUESTION

Set this keyword to create a "Question" dialog. The default dialog type is "Warning".

RESOURCE_NAME

A string containing an X Window System resource name to be applied to the dialog. See RESOURCE_NAME for a complete discussion of this keyword.

TITLE

Set this keyword to a scalar string that contains the text of a title to be displayed in the dialog frame. If this keyword is not specified, the dialog has the dialog type as its title as shown in Types of DIALOG_MESSAGE Dialogs . This keyword is ignored on Macintosh platforms.