User Tools

Site Tools


token:TriggerValue

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
token:TriggerValue [2016/08/18 02:17]
peternlewis CALCULATE(%TriggerValue%)
token:TriggerValue [2019/09/16 11:31]
JMichaelTX ADD info about Execute a Macro
Line 1: Line 1:
 The //​%TriggerValue%//​ token returns the value associated with how the macro was triggered. The //​%TriggerValue%//​ token returns the value associated with how the macro was triggered.
  
-Different ways ofd triggering the macro will set this field differently.+Different ways of triggering the macro will set this field differently.
  
 * You can pass an explicit value in using the "with parameter"​ option when executing a script from AppleScript. * You can pass an explicit value in using the "with parameter"​ option when executing a script from AppleScript.
Line 7: Line 7:
 * You can pass an explicit value in when executing the macro via the web server. * You can pass an explicit value in when executing the macro via the web server.
 * You can pass an explicit value in when executing the macro via the [kmtrigger URL](trigger:​URL). * You can pass an explicit value in when executing the macro via the [kmtrigger URL](trigger:​URL).
-* It will reflect the exact text you typed to trigger a [Typed String trigger](trigger:​Typed_String). 
-* It will reflect the current modifiers when triggering a macro via the Status Menu or a Palette (Note that Option means "edit this macro instead of triggering it"). 
-* It will reflect the hot key or device key pressed. 
-* It will reflect the application name for an application trigger. 
-* It will reflect the name of the file added/​removed from a folder. 
  
-To use the %TriggerValue% token in a numeric field, use the [CALCULATE](https://​wiki.keyboardmaestro.com/​function/​CALCULATE) function: CALCULATE(%TriggerValue%)+**When a Macro is triggered, the The //​%TriggerValue%//​ token value will be based on the trigger:​** 
 + 
 +^ Trigger Type ^ `%TriggerValue%` token ^ 
 +| [Typed String trigger](trigger:​Typed_String) | the exact text you typed to trigger | 
 +| [[trigger:​Status_Menu|Status Menu]] or [[manual:​Palettes|Palette]] | the current modifiers (Note that Option means "edit this macro instead of triggering it"). | 
 +| [[trigger:​Hot_Key|Hot Key Trigger]] or [[trigger:​USB_Device_Key|USB Device Key]] | The key that was pressed. | 
 +| [[trigger:​Application|Application Trigger]] | application name | 
 +| [[trigger:​Folder|Folder Trigger]] | path of the file that was added or removed | 
 +| [Execute a Macro action](action:​Execute_a_Macro) | Although _Execute a Macro_ is _not_ technically a trigger, when a Macro is executed by this method (the "​Sub-Macro"​),​ the //​%TriggerValue%//​ token (as evaluated in the "​Sub-Macro"​) will be either of two values:\\ 1. The //​%TriggerValue%//​ of the calling ("​Main"​) Macro\\ OR \\ 2. The value of the Parameter of the _Execute a Macro_, **if** a Parameter is provided. | 
 + 
 +To use the %TriggerValue% token in a numeric field, use the [CALCULATE](https://​wiki.keyboardmaestro.com/​function/​CALCULATE) function: CALCULATE(%TriggerValue%)
 + 
 +You can easily access the individual parts using the token array notation, eg `%TriggerValue[3]%` will be the third comma-separated value, and `%TriggerValue[3];​%` will be the third semicolon-separated value, and `%TriggerValue[3] %` (note the space between the `]` and the `%`) will be the third space-separated value (8.0.4+).
token/TriggerValue.txt · Last modified: 2021/11/24 01:41 by peternlewis