User Tools
action:Until
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
|
action:Until [2016/02/27 05:37] AlainLifchitz add internal and forum links |
action:Until [2020/07/16 21:18] JMichaelTX ADD block on looping actions |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | The Until action executes a list of actions until conditions are met. | + | ====== Until Action ====== |
| - | {{:action:until.png|}} | + | ===== Definition ===== |
| + | |||
| + | The Until action executes a list of actions until conditions are met. The Until action condition is not evaluated UNTIL the end of the Until Loop, so it will always execute all Actions in the _Until_ block at least once.\\ | ||
| + | It is one of several Actions that _loop_ through a set of other Actions until some criteria is met. | ||
| + | |||
| + | **Looping Actions** | ||
| + | |||
| + | * [[action:For_Each|For Each]] action | ||
| + | * [[action:Repeat|Repeat]] action | ||
| + | * [[action:Until|Until]] action | ||
| + | * [[action:While|While]] action | ||
| + | |||
| + | |||
| + | ===== How To Use ===== | ||
| + | |||
| + | {{:action:until_action_image_--_km_8.2.png?nolink|}} | ||
| Drag one or more actions into the //No Action// area. | Drag one or more actions into the //No Action// area. | ||
| Select a way to meet the conditions: | Select a way to meet the conditions: | ||
| - | *Any of the following are true — at least one condition must be true. | + | * Any of the following are true — at least one condition must be true. |
| - | *All of the following are true — every condition must be true. | + | * All of the following are true — every condition must be true. |
| - | *None of the following are true — no condition is true. | + | * None of the following are true — no condition is true. |
| - | *Not all of the following are true — at least one condition must be false. | + | * Not all of the following are true — at least one condition must be false. |
| Add a new condition by clicking the green + button beside //New Condition// to select from a list of available conditions. | Add a new condition by clicking the green + button beside //New Condition// to select from a list of available conditions. | ||
| Conditions are grouped by category. See the [[:Conditions|Conditions]] section for further details. | Conditions are grouped by category. See the [[:Conditions|Conditions]] section for further details. | ||
| - | *[[condition:Application|Application]] | + | |
| - | *[[condition:Button|Button]] | + | ~~NOCACHE~~ |
| - | *[[condition:Calculation|Calculation]] | + | <nspages condition -textPages=""> |
| - | *[[condition:Calculation|Clipboard]] | + | |
| - | *[[condition:Environment_Variable|Environment Variable]] | + | |
| - | *[[condition:Found_Image|Found Image]] | + | |
| - | *[[condition:Key|Key]] | + | |
| - | *[[condition:Location|Location]] | + | |
| - | *[[condition:Macro|Macro/Macro Group]] | + | |
| - | *[[condition:Menu|Menu]] | + | |
| - | *[[condition:Modifiers|Modifiers]] | + | |
| - | *[[condition:Mounted_Volume|Mounted Volume]] | + | |
| - | *[[condition:Path|Path]] | + | |
| - | *[[condition:Pixel|Pixel]] | + | |
| - | *[[condition:Script|Script]] | + | |
| - | *[[condition:Text|Text]] | + | |
| - | *[[condition:Typed_String|Typed String]] | + | |
| - | *[[condition:USB_Device|USB Device]] | + | |
| - | *[[condition:Variable|Variable]] | + | |
| - | *[[condition:Any_Window|Any Window]] | + | |
| - | *[[condition:Front_Window|Front Window]] | + | |
| - | *[[condition:Wireless_Network|Wireless Network]] | + | |
| After selecting a condition category you can make further choices. For example, if you choose the //Application Condition// you can choose a specific application to be running, or at the front, and so on. | After selecting a condition category you can make further choices. For example, if you choose the //Application Condition// you can choose a specific application to be running, or at the front, and so on. | ||
| Add further conditions by clicking the green + button again. | Add further conditions by clicking the green + button again. | ||
| + | |||
| + | You can break out of the loop, retry this iteration, or skip to the next iteration with the [[actions:Redirect_Control_Flow|actions:Redirect Control Flow]] actions. | ||
| + | |||
| + | ===== Examples ===== | ||
| + | |||
| + | **Example 1** | ||
| + | |||
| + | {{:action:until.png?511|}} | ||
| + | |||
| + | **Example 2** | ||
| + | |||
| + | See this Keyboard Maestro Forum post: [About the "Until" action functioning](https://forum.keyboardmaestro.com/t/about-the-until-action-functioning/12812/2) | ||
| ===== See Also ===== | ===== See Also ===== | ||
| - | ==== Documentation ==== | + | === Actions === |
| - | * [[action:Pause|action:Pause Until Conditions Met]] | + | * [[action:If Then Else|If Then Else]] |
| + | * [[action:Pause_Until|Pause Until]] | ||
| + | * [[action:For_Each|For Each]] action | ||
| + | * [[action:Repeat|Repeat]] action | ||
| + | * [[action:While|While]] action | ||
| + | * [[action:Assert|Assert]] action | ||
| + | * [[actions:Redirect_Control_Flow|Redirect Control Flow]] actions | ||
| + | * [[:Actions|See all Actions]] | ||
| + | === Conditions === | ||
| + | |||
| + | * [[:Conditions|See all Conditions]] | ||
| ==== Forum ==== | ==== Forum ==== | ||
| - [[https://forum.keyboardmaestro.com/t/issue-pause-until-action-fails-with-no-windows/3022/7|ISSUE: PAUSE UNTIL Action Fails with No Windows]] | - [[https://forum.keyboardmaestro.com/t/issue-pause-until-action-fails-with-no-windows/3022/7|ISSUE: PAUSE UNTIL Action Fails with No Windows]] | ||
| + | |||
| + | - [[https://forum.keyboardmaestro.com/search?q=Until|Keyboard Maestro Forum topics about Until action]] | ||
action/Until.txt · Last modified: 2021/10/14 00:33 by peternlewis
Page Tools
