User Tools
token:TriggerValue
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
token:TriggerValue [2017/04/26 08:45] cfriend spelling |
token:TriggerValue [2019/08/19 17:20] JMichaelTX CHG: Put Trigger Types in Table |
||
|---|---|---|---|
| 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 | | ||
| + | |||
| + | 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
Page Tools
