MessageBox action

Select the desired message box buttons from the drop-down list; the message box result corresponds to the button that the user clicked (see table above). The following choices are available:

Note: The message box buttons are automatically localized for the current installation language, so the actual buttons will show the localized equivalents of OK, Cancel, etc.

Select the button that must act as the default button from the drop-down list. The available choices refer to the buttons that you selected for the Buttons field, numbered in the order that the buttons appear in that field.

The default button is preselected when the message box appears. If the user presses the Enter key without selecting a different button first, then the default button determines the message box result.

Tip: The default button should be the one that returns the preferred or least dangerous result, because many users press Enter without really reading the message box.

Select the desired message box icon from the drop-down list. The following choices are available:

Enter the time-out period for the message box in seconds. If the user doesn't close the message box within the time-out period, it will be closed automatically. In that case, the message box returns the default result as specified by Result (below).

• If you leave this field empty or set it to 0 (zero) or a non-numerical value, then the default time-out period of 300 seconds will be used.
• To disable the time-out period, enter a large unsigned 32-bit value, for example 0xFFFFFFFF. In that case, the message box will remain on the screen until the user dismisses it by clicking on a button.

Select the default message box result from the drop-down list. The available choices correspond to the possible message box buttons and have the same effect on the execution of the parent action sequence (see table above). The default result is returned under the following circumstances:

• If the installer is running in silent mode, the MessageBox action does not display the actual message box but immediately returns the default result.
• If the installer is not running in silent mode but the user does not close the message box within the specified time-out period, then the message box is closed automatically and returns the default result.

Tip: The default result is usually one of the buttons that you selected under Buttons. However, this is not required; you may select a Result that is not among the buttons shown in the message box. This is useful if you want to return a different result for a message box that ends because of a time-out or was suppressed during a silent installation, than for one that is closed explicitly by the user.

For example, you could create a MessageBox action with Buttons set to OK and Result to Cancel, then select Fail mode (below) Fail if Cancel. This would terminate the installation if the message box timed out or if the installer runs in silent mode, but continue if the user was present and clicked OK to close the message box.

Select the desired installation failure mode for the action. The following choices are available:

Enter the conditional expression that determines if the action will be executed, or leave empty for unconditional execution.

Tip: You do not have to make the MessageBox action conditional upon a silent install (/q or /q2 command line option; TsuQuiet variable > 0); the message box is automatically suppressed if the installer runs in silent mode. Note that this differs from suppressing the action with a condition:

• With the automatic silent install suppression Result is returned as the action result, which may affect the parent action sequence as documented above. Furthermore, depending on Fail mode, the installation as a whole may be marked as failed.
• With a "false" condition, the action is not executed at all and has no effect on its parent action sequence or the installation.

The Condition field takes precedence over the silent install suppression, in that a "false" condition causes the action to be skipped altogether, for silent and interactive installs alike.