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 [2019/08/26 15:51] – ADD link to example JMichaelTXactions: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).
-    * [[https://forum.keyboardmaestro.com/t/cancel-a-specific-macro-action/15003/5?u=jmichaeltx|View/Download an example here]].+    * 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.   * 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 14: 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 =====
Line 24: Line 30:
 * [[action:Repeat|Repeat]] * [[action:Repeat|Repeat]]
 * [[action:Until|Until]] * [[action:Until|Until]]
 +* [[action:While|While]] action
 * [[action:Assert|Assert]] * [[action:Assert|Assert]]
 * [[:Actions|See all Actions]] * [[:Actions|See all Actions]]
actions/Redirect_Control_Flow.1566834664.txt.gz · Last modified: by JMichaelTX

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki