
	Version 6.3.8 for Windows	SEARCH CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— Dialog Component Reference —

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 (A253)	Input The message text to be displayed. Note: If this parameter is a dynamic 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)

SEARCH CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT