Macro Return/Stop


Neither the Macro Return or Macro Stop command opens a dialog window for editing when used in the Script or Direct Editor. Open the Script Editor and expand the Macro Control category of commands. Double click on the Macro Return or Macro Stop command to place in the script.



Macro Return

This command is intended for use with the Macro Run command to return to the top level macro. Macro Return stops the execution of the called macro. Use Macro Return in the middle of a logic statement to return to the main macro before the end of the called macro. It is not necessary to put a Macro Return at the end of the macro.


Here is an example of how this works. Macro A is the top level macro and uses the Macro Run command to execute Macro B. Macro B includes a conditional statement looking for a particular value. If the value is not found, the Macro Command stops Macro B but continues with Macro A.


In other words, inserting a Macro Return command in Macro B stops the playback of Macro B and returns to Macro A where it continues running the remainder of Macro A's script.



Macro Stop

The Macro Stop command stops the execution of a macro. Use this primarily in conjunction with a conditional statement. If a desired condition is not met, terminate the macro.


In the Macro Return example above, if Macro B executes a Macro Stop, both Macro A and Macro B are terminated immediately.



Note: It is not necessary to place a Macro Stop command as the last line of a macro. The macro stops automatically after the last line of the macro is executed.