User Tools

Site Tools


actions:Redirect_Control_Flow

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
actions:Redirect_Control_Flow [2020/12/23 13:02] – [Actions] peternlewisactions:Redirect_Control_Flow [2026/01/02 03:24] (current) peternlewis
Line 6: Line 6:
   * Cancel All Other Macros — Cancel all macros except this macro instance.   * Cancel All Other Macros — Cancel all macros except this macro instance.
   * Cancel This Macro — Cancel this macro and any macros that executed this macro.   * Cancel This Macro — Cancel this macro and any macros that executed this macro.
-  * Cancel Just This Macro — Cancel just this macro, continue executing the macro that executed this macro.+  * Cancel Just This Macro — Cancel just this macro, continue executing the macro that [[action:Execute_a_Macro|executed]] this macro (use [[action:Return_from_Subroutine|Return from Subroutine]] for macros executed by [[action:Execute_a_Subroutine|Execute a Subroutine]]).
   * Cancel a Specific Macro (v9.0+) — Cancels a specific macro instance (from the [[token:ExecutingInstance|%ExecutingInstance%]] or [[token:ExecutingInstances|%ExecutingInstances%]] tokens).   * Cancel a Specific Macro (v9.0+) — Cancels a specific macro instance (from the [[token:ExecutingInstance|%ExecutingInstance%]] or [[token:ExecutingInstances|%ExecutingInstances%]] tokens).
     * Forum example: [How To Stop a Specific Instance of a Running Macro](https://forum.keyboardmaestro.com/t/how-to-stop-only-this-macro-not-all/17263)     * Forum example: [How To Stop a Specific Instance of a Running Macro](https://forum.keyboardmaestro.com/t/how-to-stop-only-this-macro-not-all/17263)
     * [[https://forum.keyboardmaestro.com/t/cancel-a-specific-macro-action/15003/5?u=jmichaeltx|See another example here]].     * [[https://forum.keyboardmaestro.com/t/cancel-a-specific-macro-action/15003/5?u=jmichaeltx|See another example here]].
 +    * Note that the empty string, or the string “THIS” will cancel the currently executing macro.
   * Retry This Loop — Skip to the start of this loop and continue executing.   * Retry This Loop — Skip to the start of this loop and continue executing.
   * Continue Loop — Skip to the end of this loop and continue executing, possibly looping.   * Continue Loop — Skip to the end of this loop and continue executing, possibly looping.
Line 15: Line 16:
  
 Whichever action you choose you can still select one of the others from the pop-up menu. Whichever action you choose you can still select one of the others from the pop-up menu.
 +
 +For these purposes, any of the loop actions (For Each, Repeat, Until, While) are considered to be loops. Group is not considered to be a loop (use a `Repeat 1 Time` if you want to be able to Continue or Retry or Break from a single list of actions that is otherwise executed once).
 +
 +The behaviour of the Retry, Continue, or Break From Loop actions is undefined if they are not within a loop and is subject to change. Currently the surrounding macro itself is considered a loop.
  
 ===== See Also ===== ===== See Also =====
actions/Redirect_Control_Flow.1608728562.txt.gz · Last modified: by peternlewis

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki