You are here: Help Topics > Customization > Calculation > Launch Message Box Action

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

Related Topics