MESSAGE-BOX Action

#### Search Results

Search

# MESSAGE-BOX Action

This document covers the following topics:

- Description

- Parameters

## Description

Displays a standard modal message box.

## Parameters

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 A message box is always displayed relative to, and immediately in front of, its parent window.
Message (A) | Input The message text to be displayed. Note If this parameter is a dynamic or large alpha variable, it is possible to set a message text longer than 253 characters.
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.

#### Example:

      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)

### On this page

- Description
- Parameters