Product SiteDocumentation Site

8.3. RxMessageBox (Windows only)


>>-RxMessageBox(text-------------------------------------------->

>--+--------------------------------------------+--)-----------><
   +-,--+-------+--+--------------------------+-+
        +-title-+  +-,--+--------+--+-------+-+
                        +-button-+  +-,icon-+
Displays a Windows message box.
RxMessageBox returns the selected message box push button. Possible values are:
1
The OK push button was pressed
2
The CANCEL push button was pressed
3
The ABORT push button was pressed
4
The RETRY push button was pressed
5
The IGNORE push button was pressed
6
The YES push button was pressed
7
The NO push button was pressed
If a message box has a "CANCEL" button, the function returns the 2 value if either the ESC key is pressed or the "CANCEL" button is selected. If the message box has no "CANCEL" button, pressing ESC has no effect.
text
The message box text.
title
The message box title. The default title is "Error!".
button
The message box push button style. The allowed styles are:
"OK"
A single OK push button.
"OKCANCEL"
An OK push button and a CANCEL push button.
"RETRYCANCEL"
A RETRY push button and a CANCEL push button.
"ABORTRETRYIGNORE"
An ABORT push button, a RETRY push button and an IGNORE push button.
"YESNO"
A YES push button and a NO push button.
"YESNOCANCEL"
A YES push button, a NO push button and a CANCEL push button.
The default push button style is OK.
icon
The message box icon style. The allowed styles are:
"NONE"
No icon is displayed.
"HAND"
A hand icon is displayed.
"QUESTION"
A question mark icon is displayed.
"EXCLAMATION"
An exclamation point icon is displayed.
"ASTERISK"
An asterisk icon is displayed.
"INFORMATION"
An information icon is displayed.
"STOP"
A stop icon is displayed.
"QUERY"
A query icon is displayed.
"WARNING"
A warning icon is displayed.
"ERROR"
An error icon is displayed.

Example 8.1. RexxUtil - RxMessageBox

/* Give option to quit        */
if RxMessageBox("Shall we continue", , "YesNo", "Question") = 7
Then Exit                          /* quit option given, exit    */