The Message Box action is used to display a message on the screen. The message box can include various buttons that affect how the task proceeds.
From the Task Builder Available Actions pane, open the Dialog folder and double-click the Message Box action or drag it into the Steps pane. The following properties dialog appears:
In the Message to display box, type the message, or click the Insert Expression/Variable button and use the Expression Builder to enter a variable or expression.
Under Title of the message box, type the text to be displayed in the message box title bar.
Click the Buttons tab.
Under Buttons contained
in the message box, select the button or button combination to
Different selection boxes appear depending on the button or combination selected.
For button combinations, select which of the buttons is to be the default selection. (The sequence is from left to right.)
For each button, select the action to be taken if it is clicked. The options are:
Continue: continues the task
Stop: stops the task, but does not register a step failure. Error handling is not triggered.
Fail: causes the step to register as failed, and initiates error handling.
Start the task: starts a selected task.
For any button that is to start a task, click the Open Folder button next to the Task to start box and navigate to the task.
To set the message box position and other options, click the Advanced tab, and enter the properties as follows:
In the Position box, select from the drop-down list. For the customized selection, move the mouse pointer to the desired position for the upper left corner and press Insert. By default, the message box is positioned in the center of the screen.
To populate a variable with the return code, select the check box, and then select the variable in the box below.
If you want task execution to continue without regard to the user's input in the message box, clear the check box Execution of the task will stop until a button on the box is clicked.
To add an icon to the message box, click Display this icon, and then select an icon from the drop-down list.
To set a time-out that automatically selects the default button after a specified period, click Automatically press the default button after, and then enter the number of seconds to wait.
To set the Description tab properties, refer to Description Tab Options.
To set the Error Causes and On Error tab properties, refer to Step Error Handling.
When finished, click OK to save settings and close the properties dialog window.
Adding Task Steps
Message Box Action