IMG Developer's Kit: Developer's Kit Guide and Technical Documentation; Version 1.90; User's Guide | ||
---|---|---|
Prev | Chapter 3. My-T-Soft Developer's Kit for Windows | Next |
This utility has various options - originally it was meant to wait while a window was active, then trigger a DevKit utility once the window was dismissed. This is part of the common situations that arise when trying to integrate My-T-Soft with existing applications. Because of the structure of the utility, it also is used to launch an Application, but if the Application is already running, it will bring the running Application to the foreground (Active window).
Name: Trigger - Wait while Window, then Run Utility
Executable name: TRIGGER.EXE
Command Line Arguments: [option character]{[Class],[Text]}![command to run]!
Command Line notes: Requires Command Line of form {Class,Window Text}!command.exe! Start with ~ to display debug info, e.g. ~{Class,Window Text}!command.exe!
Start with @ to run command (launch application) if no Window found, or activate if Window found, e.g. @{Class,Window Text}!command.exe!
Start with * to close any running TRIGGER Windows, e.g. *Close existing processes
Start with + to close any running TRIGGER Windows, then start new TRIGGER
Examples:
TRIGGER {#32770,Enter Name}!MOVEWMTS x:10000 y:10000!
(When Enter Name dialog is closed, move My-T-Soft off-screen)
TRIGGER ~{#32770,Error}!MOVEWMTS x:100 y:400!
(Show debug info, When Error dialog is closed, move My-T-Soft on-screen)
(Can use Debug with other special characters, but must be second position, e.g. @~ or +~)
TRIGGER *Close Existing TRIGGERS
(Any TRIGGERs waiting on a window will be sent a close message)
TRIGGER +{#32770,Error}!MOVEWMTS x:100 y:400!
(Close any existing TRIGGER processes, then When Error dialog is closed, move My-T-Soft on-screen)
When waiting on a window, there is buffer time!
TRIGGER waits 20 seconds for specified Window to appear
If this FAILSAFEDELAY entry runs out, TRIGGER will close.
This allows a holding period for the desired window to appear.
Notes:
Must include comma between {} to record class/text!
To use NULL value for Class/Text, use character '0', e.g. {SciCalc,0}, or {0,Document}
Description: If specified Window is found, will wait until window no longer exists, or if not an exact match, will match text in Caption, and wait until Window is no longer the foreground window, then it will execute the specified command. There is a 20 second delay to wait for a window match, otherwise TRIGGER will close if no match occurs.
Description (@ option): If specified Window is found, the Windows API SetForegroundWindow will be called to bring the specific app/window to the foreground (Active window). If the specified Window is not found, the command is executed (i.e. launch the application). This mode could also be used to trigger some other utility for the case when the specified window is not running, but was designed to launch the application associated with the window class/text.
Notes: This utility was requested by a DeltaV developer, and has been modified to handle more options. If run with no command line, a message box will be displayed indicating command line options.
Support: My-T-Soft 1.x (Note: not tied to version)
As seen in ...