This document covers the following topics:
Displays a standard modal message box.
Name/Data Type | Explanation |
---|---|
HANDLE OF GUI | Input
Handle of the parent dialog (or dialog element within the parent dialog). If NULL-HANDLE is specified, the active window is implicitly used as the parent window. Note: |
Message (A) | Input
The message text to be displayed. Note: |
Title (A253) | Input (optional parameter)
The text to be displayed in the title bar of the message box. If this parameter is not supplied, the message box is displayed with no title. |
Style (A32) | Input (optional parameter)
The type of message box (for possible input values, see below). If this parameter is not supplied, the message box is displayed with an OK push button, and without an icon. |
Button (A1) | Output (optional parameter)
Returns the selected button (for possible output values, see below). |
Response (I4) | Output
Natural error (if applicable). |
The Style
parameter may consist of one
or more of the following characters:
Style Value
|
Message Box Type |
---|---|
I | Informational icon (e.g., lower case "i" in blue circle) displayed. |
! | Warning icon (e.g., exclamation mark) displayed. |
S | Critical error icon (e.g., "Stop" sign) displayed. |
? | Prompt icon (e.g. question mark) displayed. Indicates that the user should make a choice between two or more options. However, it is modern practice to use one of the above icons instead, to indicate the severity of the error. |
may be combined with: | |
O | OK push button (default). |
OC | OK and Cancel push buttons. |
YNC | Yes, No, and Cancel push buttons. |
YN | Yes and No push buttons. |
RC | Retry and Cancel push buttons until the end user responds to the message box. |
may be combined with: | |
1 | Make the first push button the default (default). |
2 | Make the second push button (if any) the default. |
3 | Make the third push button (if any) the default. |
Note:
If the messagebox has the style "C",
an OK button is generated because a messagebox with only a Cancel button is not
supported.
The Button
parameter may consist of one
or more of the following characters:
Button Value
|
Selected Button |
---|---|
O | OK push button.. |
C | Cancel push button. |
Y | Yes push button. |
N | No push button. |
R | Retry push button. |
PROCESS GUI ACTION MESSAGE-BOX WITH #DLG$WINDOW 'Do you want to save the changes ?' 'Exit editor' '?YNC1' #BUTTON GIVING *ERROR
where #BUTTON is defined as:
01 #BUTTON (A1)