About Trayer ============ Trayer documentation (version 3.2.1) © Ng KimFatt 1998-2000 THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Disclaimer section of this document. 1. Introduction 2. Installation 3. Uninstallation 4. Running 5. Feedback 6. History 7. Disclaimer 8. Registration Ng KimFatt (ngkf@kfsoft.com) 4th July 2000 1. Introduction =============== Originally designed just to run applications and add icons to the System Tray area representing their presence, Trayer has since been added some nice-to-have features. Just to name a few, "Application Launcher Mode", "Auto Update Tray Icon" and also the ability to remove the Taskbar button of the target application. Ideal for background processing programs that you want to keep running without taking up any Taskbar space such as WinPopup or CD Player. With the new securities feature, you can even keep your minimized/hidden Trayer applications away from prying eyes. 2. Installation =============== If you have previous version of Trayer installed on your PC, please remove it first before you perform the following steps. To remove the previous version of Trayer, please refer to "Uninstallation" section below. I) Download Trayer: You can download the latest version of Trayer at http://www.kfsoft.com/trayer/download.htm Click the link on the Trayer page to download the file "trayer321.exe". II) Install Trayer: Double-click the downloaded "trayer321.exe" to start the installation. III) Accept the License Agreement: When prompted, click "Yes" to accept the License Agreement. Otherwise, the installation will not continue. III) Choose the destination folder: For backward compatibility reason, the default destination folder is the Windows folder. However, you can choose to install Trayer into other folders, for example, C:\Program Files\Trayer. The following files will be copied into the respective folders: Trayer.exe, Trayer.dll, Trayer.hlp & Trayer.cnt -> Folder of your choice (Default is Windows folder) Trayer.inf -> INF folder (inside Windows folder) If you love launching applications straight from the command prompt, you will want to install Trayer into Windows folder so that it can be run from any directory. 3. Uninstallation ================= Please make sure you do not have Trayer running before you perform the following steps. Otherwise, you are required to reboot Windows to complete the process. I) Open the Control Panel: On the Start Menu, choose Settings->Control Panel. II) Open "Add/Remove Programs": Find the Control Panel called Add/Remove Programs and double-click it. III) Remove Trayer: Select "Trayer (Remove Only)" on the list, then click the button marked "Add/Remove". 4. Running ========== Run Trayer.exe to configure the target application. Then, click "Create Shortcut" button to save the configuration of the target application as a shortcut, so that the next you want to run it, you can just double-click on the shortcut and have the target application run in the tray without going through the configuration steps all over again. After running the program, click the icon in the system tray to show or hide the window of the target application. It also can be configured to activate by double-click instead of single-click. Right-click the icon to bring up the context menu, which allows you to change some parameters of the running instance of Trayer, or to configure Trayer with new programs and create shortcuts. Context-sensitive help is supported in the dialog box, though it should be intuitive enough. To re-configure a Trayer shortcut, double-click the shortcut while holding down the Shift key. The Trayer Properties dialog will be displayed. After making the changes, click "Create Shortcut" button and save the shortcut with the same filename to overwrite it. The alternative of making changes to an existing Trayer shortcut is to run Trayer first, and then drag-and-drop the Trayer shortcut from Windows Explorer to the Trayer Properties dialog box. By doing this, the "Create Shortcut" button will then become "Save Shortcut", as such, you can click the "Save Shortcut" button to save and overwrite the shortcut that you have just dropped more easily. As you may notice, drag-and-drop support is added to Trayer Properties dialog box. You can also drag-and-drop executables or document files to the Properties dialog box. You can also create a shortcut to Trayer.exe and put the shortcut on the desktop, just that I personally think that it wouldn’t be very much useful, as you don’t normally run Trayer by itself. One way of using it is, you can actually drop an executable or a document to the shortcut from windows explorer to have it run right away. 5. Feedback =========== Please send in your opinions, bug reports, suggestions, etc, to me. I can be reached at ngkf@kfsoft.com 6. History ========== 04/07/2000 - 3.2.1 1. Fixed bug that fails to hide taskbar button of a popup window when minimized. 01/07/2000 - 3.2.0 1. Added support for Windows 2000. 2. Added support for DDEExec to work better with Microsoft Office 2000 applications. 3. Added "On Hide Command" option for "Hide Taskbar Button". Also the command line parameter "/hidebutton=3". This option is provided for backward compatibility with the "Don't Hide" option in the previous version. The "Don't Hide" option has been improved as mentioned below. 4. Improved "Don't Hide" option for "Hide Taskbar Button" to achieve what it is supposed to be, i.e. to hide the target window without having to hide the taskbar button. This is accomplished by moving the window off-screen instead of hiding it. 5. Fixed bug in wildcard matching algorithm. 6. Fixed bug that required Administrator's permission to run Trayer unnecessarily under Windows NT (however, it would still require Administrator's permission for installing Trayer). 21/01/2000 - 3.1.0 1. Modified "Force Target as Single Instance Application" to differentiate instances with different "Start In" parameters. 2. Modified "About" dialog box to display license information. 3. Renamed "Caption Match All" to "Caption Matching Method". 4. Added wildcard matching to the caption matching methods. 5. Added "Target might be a spawned process window" option to the "Compatibility Tweak" list. 6. Command line parameter "/matchall" should be replaced by "/match" and is provided for backward compatibility only. 01/10/1999 - 3.0.0 1. Trayer is now a Shareware. 2. Added "Always Hide" option for "Tray Icon". Also the command line parameter "/hideicon=2". 3. Added "Compatibility Tweak" options. Also added is the command line parameter "/compat". 4. Added "Dynamic Tray" function to tray active applications on-the-fly. 5. Added "About" button in Properties dialog box to display the About box. 6. Added "New" button in Properties dialog box to create a new instance of Trayer. 7. Added "Un-tray" button in Properties dialog box to un-tray without affecting a Trayer application. 8. Added routine to activate correctly windows with popup child windows. 9. Added routine to display "Launch Status", that is to put a red cross on top of the tray icon to indicate that the application is not launched (Only in Application Launcher mode). Also added is the command line parameter "/nostatus" to disable this feature. 10. Added "Password Protection" options. Also the command line parameter "/protect" and "/passcode". 11. Added support to add icons back into the tray area when Explorer (the shell) restarts due to general protection fault. 12. Added Trayer Manager. Also added is the command line parameter "/manager". 13. Command line parameter "/childwindow" should be replaced by "/compat=1" and is provided for backward compatibility only. 14. Removed "Remember Preference" option and replaced it with "Customization" options. 15. Improved Distribution Packaging to an executable installation program. 16. Fixed bug that causes a 636 bytes of memory leak occasionally; 17. Fixed bug that prevents System Menu of the target application from being activated for the second time (only under Windows NT). 18. Fixed bug that fails to update the tray icon and tooltip under certain circumstance, eventually! 19. Fixed bug that incorrectly registers as a system hook instead of an application hook for the "Taskbar button always hide" feature. 04/08/1998 - 2.3.0 1. Fixed bug that doesn't show the menu and toolbars in Excel 97 when Excel 97 is minimized and then shown by Trayer. 2. Fixed bug that fails to interpret the command line correctly if the command line consists of hyphen "-" characters. 3. Fixed bug that fails to update the tray icon and tooltip under certain circumstances. 4. Fixed bug that overwrites the memory mapped file causing 2 or more Trayer programs running concurrently to be failed under a very rare circumstance. 5. Added "Remember Preference" option to remember user's preference. At this point, only the default folder for saving Trayer shortcuts is remembered. 6. Added "Force Target as Single Instance Application" option. Also added is the command line parameter "/single". 7. Added function to bring up the System Menu of the target application by holding down Shift key while right-clicking the tray icon. 8. Added option "Might be a Child Window itself" under "Target Window" in Properties dialog box. Also added is the command line parameter "/child". 9. Polished the Error Message dialog box to give suggestions what to do when error occurs. 10. Modified the About dialog box to include the link to the Trayer home page. 13/07/1998 - 2.2.1 1. Fixed bug that fails to update the tray icon and tooltip under certain circumstances. 12/07/1998 - 2.2.0 1. Fixed bug that removes double-quotes from the command line unnecessarily. 2. Fixed bug that overwrites the memory mapped file causing 2 or more Trayer programs running concurrently to be failed. 3. Fixed bug that overwrites the Timeout timer causing 2 or more Trayer programs running concurrently to be failed. 4. Fixed bug that causes "Hide On Minimize" function inoperative when 2 or more Trayer programs are launched concurrently. The same bug also prevents Trayer from removing the icon in the system tray when the target program is terminated. 5. Added "Application Launcher" feature. Also added is the command line parameter "/launcher". 6. Added new command line parameter "/run" that runs target application in normal window, minimized or maximized. 7. Added "Auto Update Tray Icon" feature. Also added is the command line parameter "/updateicon". 8. Command line parameter "/hidetrayer" should be replaced by "/hideicon" and is provided for backward compatibility only. 9. Modified Exit command in the context menu to send SC_CLOSE to target application only instead of closing down Trayer without knowing that the target application is actually terminated. To force Trayer to close down, press and hold SHIFT key while selecting Exit. 10. Modified the error message displayed when the target window (with the caption specified by the user) cannot be located. 11. Modified the show/hide toggle behaviour to bring the target window to top instead of hiding it if the target window is shown and inactivated (for "Taskbar Button Always Hide" only). 07/06/1998 - 2.1.0 1. Fixed bug that shuts down the system when the execution timeout occurs while more than one Trayer target is running. 2. Fixed bug that interprets double-quotes in the command line wrongly. 3. Fixed bug that posts WM_CLOSE to child windows and causes illegal operation fault. 4. Fixed bug that locates hidden window as target window. 5. Fixed bug that adds double-quotes to the command line unnecessarily. 6. Fixed bug that disallows execution of shortcuts when shortcuts are passed in as command line parameters. 7. Added code to determine whether target program is written as a single instance program, so that error message will not be displayed if the second instance of the target program is executed and subsequently terminated. Instead, Trayer will try to switch to the first instance of the target program. 8. Added code to display error message if Trayer.DLL cannot be loaded (eg. File not found). In this case, taskbar button "Always Hide" feature will not be functioning. 24/05/1998 - 2.0.0 1. Call SetMenuDefaultItem() to bold default menu item. 2. Added Hotkey support to context menu. 3. Added new "Auto Hide Trayer Icon" to Properties dialog box. This feature removes icon in the System Tray automatically when the target window is shown. 4. Replaced "Hide On Minimize" in Properties dialog box with "Hide Taskbar Button". 5. Added "Always Hide" to "Hide Taskbar Button" in Properties dialog box. 6. Added new command line parameter "/hidetrayer", "/hidebutton" and "/target". 7. Command line parameter "/hideonmin" should be replaced by "/hidebutton" and is provided for backward compatibility only. 8. Added Clist to keep track the windows show mode, fixed bug that show hidden parent window of the target window unnecessarily. 9. Added radio buttons in Properties dialog box to select the Target Window type. 10. Added code to find alternative window in the same process of the target window when target window is destroyed. This behaviour is determined by the Target Window type. 11. Added code to show/hide the target window and all its child windows. This behaviour is determined by the Target Window type. 12. Added code to show/hide all the windows in the same process of the target window. This behaviour is determined by the Target Window type. 13. Added code to send WM_CLOSE to all the child windows of the target window then finally the target window. 14. Command line parameters that have default values will no longer be saved into the shortcut. This is to solve command line parameters too long problem. 15. Added dialog box icon for Properties dialog box and Target Program Info dialog box. 16. Added "Auto Refresh" to update Program Info dialog box automatically. 17. Added "Always On Top" to keep Program Info dialog box always on top of other windows. 18. Modified Properties dialog box into PropertySheet with "General" page and "Advanced Settings" page. 19. Separated hook functions from Trayer.exe to Trayer.dll for taskbar button "Always Hide" feature. 20. Added Drag & Drop support to accept files drop into Properties dialog box. 21. Changed default icon file to SHELL32.DLL instead of PIFMGR.DLL. 22. Redesign Trayer to run as single instance program. 23. Added awareness of environment strings in command line, e.g. %SystemRoot% for Windows NT. 24. Added awareness of Prefix "Shortcut to" setting in TWEAKUI. 25. Added "Browse" button to select folder for "Start in" parameter in Properties dialog box. 26. Added "Icon chooser" dialog box in Properties dialog box. Thanks Victor Vogelpoel from Netherlands for sending me the code, which is written by PJ Naughter. 27. Fixed bug of TrackPopupMenu(), whereby the context menu appears when clicked and immediately disappears by itself. 28. Fixed bug that terminates Trayer when the target program terminates itself after executing another program, even if "Window Name/Caption" is specified. 29. Fixed bug that changes icon in the Properties dialog unnecessarily. 30. Fixed bug that shows incorrect value of Process ID and Thread ID in Program Info dialog box. 31. Fixed bug that shows Properties dialog box as minimized or maximized when shift-double-clicking the shortcut (if the shortcut is configured to run as minimized or maximized). 32. Fixed bug that targeted wrongly on an existing window as the target window which caption happens to match the "Window Name/Caption" specified. 33. Fixed bug that interprets executable filename wrongly as a command line argument. 12/04/1998 - 1.0.0 Initial Release. 7. Disclaimer ============= Trayer is a Shareware, which means that you can use it legally for 30 days free-of-charge to evaluate it. If during, or at the end of, that period you decide that you would like to continue using it, please register your copy. Unregistered version of Trayer will stop functioning after 30 days. Your single-user registration will license you to use one copy of Trayer on only one computer at a time. If you have multiple licenses of Trayer, you may use as many copies at any time as you have a license. "Use" means loaded in temporary memory or permanent storage on the computer. Installation on a network server solely for distribution to other computers is not "use", if you have a separate license for each computer to which the software is distributed. Please see the Registration section to find out how you can register. Trayer may be freely distributed subject to, but not limited to, the following terms: Trayer may not be sold or resold, distributed as a part of any commercial package, used in a commercial environment, used or distributed in support of a commercial service, or used or distributed to support any kind of profit-generating activity, even if it is being distributed freely. If you would like to distribute Trayer as part of a shareware distribution, magazine, Internet book, CD ROM, etc. contact me for written permission. All commercial use interests in Trayer eg. site licensing, should be directed to the Author. The integrity of the original Trayer distribution file as distributed by the Author is essential. Trayer and all of its related files must be distributed together in the original format. The Trayer distribution file may not have files added to it or removed from it, and none of its contents may be modified, decompiled, or reverse engineered. Trayer is provided AS IS without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. In no event shall the Author be liable for any damages whatsoever including direct, indirect, incidental, consequential, loss of business profits or special damages, even if the Author has been advised of the possibility of such damages. 8. Registration =============== The current registration amount is US$12.00. This is a one-time registration fee for your current version of Trayer. You can register Trayer either by: 1. Secured online registration with your MasterCard, Visa or American Express Credit Card. 2. Telephone, fax or by check through postal mail. Please refer to http://www.kfsoft.com/trayer/register.htm for more details. Once I receive your registration, I will send you an email with your license key. You can then enter your license key in the registration dialog by going to the About dialog box in Trayer (or through Trayer Manager), and clicking the Register button. If you've submitted a registration and haven't received a reply after 3 days, you can email me at sales@kfsoft.com to check up on the status of your registration. =============== End of Document ===============