Macro Message Boxes (With Buttons)

Macros : WaitMsg, WaitMsgTitle, WaitMsgType, WaitMsgAns

WaitMsg="Click OK to resume macro..." shows a standard Windows message box with an ' OK' button. After the message is shown, macro processing halts until the user responds to the message.

WaitMsg has a default title bar that shows "Macro Wait" above the message text. WaitMsgTitle="New Wait Title" changes it to "New Wait Title". WaitMsgTitle= specifies an empty title bar. Titles may be up to 32 characters long, and will be used with subsequent WaitMsg macros until specifically changed.

You can change WaitMsg features with WaitMsgType. The default is WaitMsgType=O for OK. You can choose an icon for the message, the number and type of buttons, and the default button (the one that is chosen by just hitting the Enter key) by including a character from each of these groups:

• S = Stop-sign icon.
• Q = Question mark.
• E = Exclamation point.
• I = Information ('i' in a circle).

• O = OK button only.
• C = OK and Cancel buttons.
• A = Abort, Retry, Ignore.
• X = Yes, No, Cancel.
• Y = Yes, No.
• R = Retry, Cancel.

• 1 = 1st button default.
• 2 = 2nd button default.
• 3 = 3rd button default.

So, for example WaitMsgType=EX2 will show subsequent WaitMsg text with an Exclamation point icon and Yes, No, Cancel buttons, with the No button the default.

WaitMsg is used to wait for a response from the user. If it is just to have the user confirm that he has read the message, the default OK type can be used. Macro processing will stop after the WaitMsg command until the OK button is clicked or the message box is dismissed with the [x] button, then proceed with the next macro command:

 
 WaitMsg="1) Attach electrodes to monster.
 2) Raise platform.
 3) Turn dial to 'Danger'.
 4) Click 'OK' to proceed..."
 @Reanimate
 

The above example shows a multi-line message (note the quote marks at the beginning and end), then waits for 'OK' before running the Reanimate macro.

If you ask the user to make a decision, such as with a Yes/No message, you can provide different macro actions based upon the response. The WaitMsgAns command is used in an IF statement to obtain a number corresponding to the user action:

 WaitMsgType=EY2     ;!, Yes/No, No default
 WaitMsg="Ignore Reactor Warning Alarm?"
 IF.WaitMsgAns=6     ;6=YES
     @MaxPower
 ELSE.
     @ShutDown
 ENDIF.

The possible response values (depending on message type) are:

• 1 = OK
• 2 = Cancel
• 3 = Abort
• 4 = Retry
• 5 = Ignore
• 6 = Yes
• 7 = No
• 8 = Close

See also Message Macros, Macro Overview