This shows you the differences between two versions of the page.
Next revision | Previous revision Next revision Both sides next revision | ||
token:TriggerValue [2015/07/15 06:18] peternlewis created |
token:TriggerValue [2017/11/06 01:34] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The //%TriggerValue%// token returns the value associated with the trigger (eg the typed string, or the hot key pressed, or the parameter passed by the [Execute a Macro action](action:Execute_a_Macro) or via AppleScript or the web server. | + | The //%TriggerValue%// token returns the value associated with how the macro was triggered. |
+ | |||
+ | 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 when using the [Execute a Macro action](action:Execute_a_Macro). | ||
+ | * 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). | ||
+ | * 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%). | ||
+ | |||
+ | 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+). |