I am working on a macro that will use a Focused Window Trigger. Unfortunately, it appears that this trigger is incompletely documented. The page defining the %TriggerValue% token does not include this trigger as a trigger type.
I have found in various places in the Forum that the TriggerValue generally contains the new window title. If the triggering window change is the closing of a window, then the TriggerValue contains the title of whatever window happens to come to the front. That's enough to work with, but it would be nice to have this documented, especially if there are special cases other than the closing of a window.
I also noticed that the page does not list the %TriggerValue% for the Space Changed trigger. That one's special to me because I lobbied for a couple of years and did a bunch of research to help that one come in to being.
So I did the "due diligence" / ADHD thing and cross-checked them all.
The %TriggerValue% Token Wiki page is missing any statement of what the TriggerValue is for these triggers:
- Clipboard Changed Trigger
- Clipboard Filter Trigger
- Focused Window Trigger
- Gesture Trigger
- Login Trigger
- Periodic Trigger
- Public Web Trigger
- Sleep Trigger
- Space Changed
- Time of Day Trigger
- Wake Trigger
- Wireless Network Trigger
While some of these are probably "null" or "the empty string" (like Login trigger, the Wake trigger), it seems to me that many of these triggers could have useful information in the %TriggerValue%. For instance, the Time of Day trigger could (should?) have the time that produced the triggering.
In all cases there should be some indication of what value will be found in the TriggerValue, even if it's empty.
In addition, the TriggerBase Token page does not indicate that these trigger types have a value for %TriggerBase%:
- Display Layout Changed trigger
- Execute a Macro action
- Script trigger
- Status Menu or Palette item
- Trigger File
- Typed String trigger
- URL trigger
To support @peternlewis in keeping the pages updated, if you use these triggers and know what the TriggerValue is for any of them, or have suggestions of useful information that could be contained in them, please make suggestions.
UPDATE: I've moved this to the Wiki category so now I feel free to mention that I've been given Edit permission in the Wiki and I would like to updat this page. However, I'm certainly not the SME (Subject Matter Expert) to fill in the blanks and I don't really have time to manually test it.
Does anyone have comments on any of the items above? I'm used to merging comments from various sources into a coherent whole (nearly 40 years as a technical editor for software development doc), so just give me the notes and I'll worry about formatting.
And does anyone want to be on the review committee?