The %TriggerValue% token returns the value associated with how the macro was triggered.
Different ways of triggering the macro will set this field differently.
When a Macro is triggered, the The %TriggerValue% token value will be based on the trigger:
|Application trigger||The Path to the application that was triggered.|
|Audio Output Changed trigger||The name of the selected audio output device.|
|Cron trigger|| The current time and date (
|Display Layout Changed trigger||A comma separated list of the kinds of changes made.|
|Dragged File trigger||The path of the dragged file.|
|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
2. The value of the Parameter of the Execute a Macro, if a Parameter is provided.
|Folder Trigger||Path of the file that was added or removed.|
|Hot Key Trigger||The key that was pressed.|
|Idle trigger||The number of minutes the Mac has been idle.|
|MIDI trigger|| A comma separated list of
|Mounted Volume trigger||The name of the volume.|
|Remote trigger||The TriggerValue used in the Remote Trigger URL.|
|Script trigger||Although not technically a trigger, when a Macro is executed via AppleScript the %TriggerValue% token will contain the passed parameter.|
|Status Menu or Palette||The current modifiers (Note that Option means “edit this macro instead of triggering it”).|
|Trigger File trigger||The path of the Trigger File.|
|Typed String trigger||The exact text you typed to trigger.|
|URL trigger||The TriggerValue used in the URL.|
|USB Device trigger||The name of the device.|
|USB Device Key||The key that was pressed.|
To use the %TriggerValue% token in a numeric field, use the CALCULATE function: CALCULATE(%TriggerValue%).
You can easily access the individual parts using the token array notation, eg
%TriggerValue% will be the third comma-separated value, and
%TriggerValue;% will be the third semicolon-separated value, and
%TriggerValue % (note the space between the
] and the
%) will be the third space-separated value (8.0.4+).