You are here: Features > Action Events > Launch Message Box

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" No icon displayed. "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

Launch Message Box Action

Cookie Notice