I want to have a macro that does different things based on the hotkey that triggers it. In searching for that, I very quickly found %TriggerValue%, whose description says it's so we can do exactly that.
But what are we comparing it to? I've searched for every combination of "key(s)," "keystrokes," etc., in help, on the Wiki, and in the forum, and haven't found anything that says what value to put in the "is" for a particular key. If I want to compare %TriggerValue% to Alt-Ctrl-K or Cmd-F1 or whatever, how are the keys described in the "is" textbox? (And, as a bonus, where is the answer documented?)
Just run a simple experiment—set a trigger on a macro whose only content is:
Display text: %TriggerValue%
Then vary the trigger to see the different text you get back. In your comparison, you'll use a text comparison, for the text %TriggerValue% matches, contains, whatever, etc.
So every person using %TriggerValue% has to completely reinvent the wheel? There's no documentation in KM on what the values of keys are? That seems … well, a lot of things, but "less than optimal" is the kindest.
I'll do one or the other of these things, but we shouldn't have to.
Hmm, I think maybe you meant to be asking about the %Trigger% token, not the %TriggerValue% token. I was specifically answering your question about the %TriggerValue% token. You might have a point if you meant to say the %Trigger% token. In any case, if you use my action above, you can find the names of any keys easily enough. But it may be better to replace my "Display Progress Bar" action with "Display Text in a Window" because then you can copy and paste the exact string for any key you want to test into some other location.
No -- for a hot key trigger, the %TriggerValue% evaluates to a literal text representation of what was pressed:
To easily get those meta characters you could follow @griffman's suggestion and "Display Text" the %TriggerValue% then Copy from there and Paste into the comparison text field. Or install "Menu Glyphs" from the KM Macro Library. Or search the Forum -- many people have posted their own expanded versions of the Menu Glyphs macros.
...though that should perhaps be "the key combination that was pressed". And since it's a text Token you simply evaluate it then make your comparisons.
