(Windows, ATE) Add a configurable "Print Screen" option to the File menu.
Although the option is customizable (and easily removed), we decided to define a default behavior and place on the menu to reduce the confusion that has historically surrounded the print screen function.
The behavior of the option is determined by a configuration file, BAS:APRNTSCRN.CFG, which should be formatted as follows:
;<comments may begin with semicolon>
[MENU]
Command=SBX:APRNTSCRN
A default APRNTSCRN.CFG configuration file (formatted as above) is included in the installation/update packages, but will not overwrite an existing copy.
The APRNTSCRN.SBX file (and its source, APRNTSCRN.BP) will be supplied (and overwritten) during installation/update. So if you want to modify the default print screen behavior, you should supply your own SBX and plug its name into the Command= line of the APRNTSCRN.CFG file.
To remove the item from menu, just comment out (or remove) the Command= line from the APRNTSCRN.CFG file. To accomplish this for many ATE clients in one step, you can use ATSYNC.LIT in a startup command file to update the individual copies of APRNTSCRN.CFG from the server. Or, even simpler, just send a command to delete the APRNTSCRN.CFG file, e.g.
? TAB(-10,AG_WINEXEC);"$DEL %MIAME%\DSK0\007006\APRTNSCRN.CFG";chr(127);
or, using the AGCMD.EXE:
.AGCMD WINEXEC $DEL %MIAME%\DSK0\007006\APRNTSCRN.CFG
As an alternative to calling an SBX to perform the print screen function, you can specify an arbitrary Windows command line (removing the "SBX:"), e.g.:
[MENU]
Command=super-print-screen.exe -arg1 -arg2 -arg3
Note that the APRNTSCRN.CFG file is only processed by the menu subsystem the first time you click on the menu bar. So removing it or changing the Command= line after the menu has already been accessed will have no further effect until you close and re-launch the session.