Differences

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

--- actions:Redirect_Control_Flow [2017/09/07 05:58] – peternlewis
+++ actions:Redirect_Control_Flow [2024/12/06 02:59] (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 (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.
   * Break From Loop — Cancel execution of the current loop, continue executing after the loop
-Whichever action you choose you can still select one of the others from the pop-up.
+Whichever action you choose you can still select one of the others from the pop-up menu.
 ===== See Also =====
-=== Actions ===
+==== 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]]
-=== Tokens ===
+==== Tokens ====
 * [[token:ExecutingMacro|%ExecutingMacro%]]
@@ Line 32: / Line 37: @@
 * [[token:ExecutingThisMacro|%ExecutingThisMacro%]]
 * [[token:ExecutingThisMacroUUID|%ExecutingThisMacroUUID%]]
+* [[token:ExecutingInstance|%ExecutingInstance%]]
+* [[token:ExecutingInstances|%ExecutingInstances%]]
 * [[:Tokens|See all Tokens]]
@@ Line 45: / Line 52: @@
 - [[https://forum.keyboardmaestro.com/search?q=Break From Loop|Keyboard Maestro Forum topics about Break From Loop]]