Launch Message Box Action
Event Function: LaunchMessageBox
The Launch Message Box event creates a message box with selectable responses.
Using the Events tab:
| Under | Enter | Example |
|---|---|---|
|
Run Skip Condition |
If desired, enter skip conditions for the event. When the "Run Skip Condition" is evaluated to be true, the action is not performed. |
|
|
Result Cell |
The cell number where the Message Box result will be sent. |
"C100" |
|
Message |
The contents of the Message Box. |
"Do you want to include adjustments?" |
|
Title |
The title of the Message Box, this will appear in the title bar at the top of the box. |
"Adjusted Totals" |
|
Icon |
The image that appears in the Message Box. |
"Error" "Exclamation" "Information" "None" "Question" |
|
Buttons |
The choice of button sets to appear in the Message Box. |
"Abort/Retry/Ignore" "Cancel/Try Again/Continue" "Ok" "Ok/Cancel" "Retry/Cancel" "Yes/No" "Yes/No/Cancel" |
|
Default Button |
The button that is in focus by default in the Message Box. |
"Button 1" "Button 2" "Button 3" |
Syntax (if entering it in the Equation bar)
ACTION("LaunchMessageBox",expr1, expr2, expr3, expr4, expr5,expr6)
Where
expr1 = Result Cell
expr2 = Message
expr3 = Title
expr4 = Icon
expr5 = Buttons
expr6 = Default Button
How the example will appear in the Equation bar
ACTION("LaunchMessageBox","C41","Do you want to include adjustments","Adjusted Totals","Question","Yes/No","Button1")
Message Box results
The various buttons which may be presented in a message box give the Result Cell a numerical value which may be used elsewhere in the document to perform a variety of tasks, such as skipping/hiding content.
|
Button |
Result |
|
OK |
1 |
|
Cancel |
2 |
|
Abort |
3 |
|
Retry |
4 |
|
Ignore |
5 |
|
Yes |
6 |
|
No |
7 |
|
Try Again |
10 |
|
Continue |
11 |
