Differences

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

--- actions:Redirect_Control_Flow [2019/07/15 03:26] – peternlewis
+++ actions: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 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 — Cancels a macro based on its 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)
+    * [[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.
   * Continue Loop — Skip to the end of this loop and continue executing, possibly looping.
@@ Line 13: / Line 16: @@
 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 =====
@@ Line 18: / Line 25: @@
 ==== Actions ====
-* [[action:If Then Else|If Then Else]] action
+* [[action:If Then Else|If Then Else]]
-* [[action:Pause_Until|Pause Until]] action
+* [[action:Pause_Until|Pause Until]]
-* [[action:For_Each|For Each]] action
+* [[action:For_Each|For Each]]
-* [[action:Repeat|Repeat]] action
+* [[action:Repeat|Repeat]]
-* [[action:Until|Until]] action
+* [[action:Until|Until]]
-* [[action:Assert|Assert]] action
+* [[action:While|While]] action
+* [[action:Assert|Assert]]
 * [[:Actions|See all Actions]]