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
token:TriggerValue [2019/09/16 11:31]
JMichaelTX ADD info about Execute a Macro
token:TriggerValue [2021/11/24 01:41] (current)
peternlewis
Line 11: Line 11:
  
 ^ Trigger Type ^ `%TriggerValue%` token ^ ^ Trigger Type ^ `%TriggerValue%` token ^
-| [Typed String ​trigger](trigger:​Typed_String) ​| the exact text you typed to trigger ​+| [[trigger:​Application|Application]] trigger | The Path to the application that was triggered. ​
-| [[trigger:Status_Menu|Status Menu]] or [[manual:​Palettes|Palette]] | the current modifiers (Note that Option means "edit this macro instead of triggering it"). | +| [[trigger:Audio_Output_Changed|Audio Output Changed]] trigger ​The name of the selected audio output device. | 
-| [[trigger:Hot_Key|Hot Key Trigger]] or [[trigger:​USB_Device_Key|USB Device Key]] | The key that was pressed. | +| [[trigger:Cron|Cron]] trigger | The current time and date (`yyyy-mm-dd hh:mm`). | 
-| [[trigger:Application|Application Trigger]] | application name +| [[trigger:Display_Layout_Changed|Display Layout Changed]] trigger ​A comma separated list of the kinds of changes made. 
-| [[trigger:Folder|Folder Trigger]] | path of the file that was added or removed ​+| [[trigger:Dragged_File|Dragged File]] trigger ​The path of the dragged ​file
-| [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. |+| [[action:​Execute_a_Macro|Execute a Macro]action | 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. | 
 +| [[trigger:​Folder|Folder Trigger]] | Path of the file that was added or removed. | 
 +| [[trigger:​Hot_Key|Hot Key Trigger]] | The key that was pressed. | 
 +| [[trigger:​Idle|Idle]] trigger | The number of minutes the Mac has been idle. | 
 +| [[trigger:​MIDI|MIDI]] trigger | A comma separated list of `channel,​note,​velocity,​device`. | 
 +| [[trigger:​Mounted_Volume|Mounted Volume]] trigger | The name of the volume. | 
 +| [[trigger:​Remote|Remote]] trigger | The TriggerValue used in the Remote Trigger URL. | 
 +| [[trigger:​Script|Script]] trigger | Although _not_ technically a trigger, when a Macro is executed via AppleScript the //​%TriggerValue%//​ token will contain the passed parameter. | 
 +| [[trigger:​Status_Menu|Status Menu]] or [[manual:​Palettes|Palette]] | The current modifiers (Note that Option means "edit this macro instead of triggering it"). | 
 +| [[trigger:​Trigger_File|Trigger File]] trigger | The path of the Trigger File. | 
 +| [[trigger:​Typed_String|Typed String]] trigger | The exact text you typed to trigger. | 
 +| [[trigger:​URL|URL]] trigger | The TriggerValue used in the URL. | 
 +| [[trigger:​USB_Device|USB Device]] trigger | The name of the device. | 
 +| [[trigger:​USB_Device_Key|USB Device Key]] | The key that was pressed. |
  
 To use the %TriggerValue% token in a numeric field, use the [CALCULATE](https://​wiki.keyboardmaestro.com/​function/​CALCULATE) function: CALCULATE(%TriggerValue%). 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+). 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+).
 +
 +===== See Also =====
 +
 +=== Tokens ===
 +
 +* [[Trigger|%Trigger%]] token
 +* [[TriggerBase|%TriggerBase%]] token
 +* [[TriggerClipboard|%TriggerClipboard%]] token
 +* [[/​Tokens|All Tokens]]
 +
 +
token/TriggerValue.1568647902.txt.gz · Last modified: 2019/09/16 11:31 by JMichaelTX