| 1 | Extended system tray widget for XCenter/eCenter
|
|---|
| 2 | Version 0.1.0
|
|---|
| 3 |
|
|---|
| 4 | Copyright (C) 2009 Dmitry A. Kuminov
|
|---|
| 5 |
|
|---|
| 6 | Extended system tray widget is free software; you can redistribute it
|
|---|
| 7 | and/or modify it under the terms of the GNU General Public License as
|
|---|
| 8 | published by the Free Software Foundation, in version 2 as it comes in
|
|---|
| 9 | the "COPYING" file of the Extended system tray widget distribution. This
|
|---|
| 10 | program is distributed in the hope that it will be useful, but WITHOUT
|
|---|
| 11 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|---|
| 12 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|---|
| 13 | more details.
|
|---|
| 14 |
|
|---|
| 15 |
|
|---|
| 16 |
|
|---|
| 17 | INTRODUCTION
|
|---|
| 18 |
|
|---|
| 19 | The extended system tray widget is a plugin for XCenter that provides support
|
|---|
| 20 | for the system tray area in the XCenter bar. This area is commonly used by
|
|---|
| 21 | long running applications to display their status using graphical icons and to
|
|---|
| 22 | provide a way to control these applications by clicking on their icons.
|
|---|
| 23 |
|
|---|
| 24 | There is a number of other tools to implement the described functionality (for
|
|---|
| 25 | example, SysTray/WPS by Dmitry Zaharov and the XCenter plugin for it by Eugene
|
|---|
| 26 | Romanenko). The main reason to create yet another implementation is that
|
|---|
| 27 | existing ones do not provide the level of functionality required by the Qt
|
|---|
| 28 | toolkit for which this extended implementation was created for.
|
|---|
| 29 |
|
|---|
| 30 | Note that since the SysTray/WPS API is being already used by a number of OS/2
|
|---|
| 31 | applications to implement system tray icons (e.g. PM Downloader, CoolFM), the
|
|---|
| 32 | Extended system tray widget implements this API as well to provide backward
|
|---|
| 33 | compatibility. See the API file for more information.
|
|---|
| 34 |
|
|---|
| 35 | The word "extended" in the widget name is used to distinguish from the XCenter
|
|---|
| 36 | widget by Eugene Romanenko and also to indicate that this one provides some
|
|---|
| 37 | extended functionality (for example the ability to add any valid icon to the
|
|---|
| 38 | tray, not only the frame window's icon).
|
|---|
| 39 |
|
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 | INSTALLATION
|
|---|
| 43 |
|
|---|
| 44 | In order to manually install the extended system tray widget plugin to XCenter,
|
|---|
| 45 | copy xsystray.dll to
|
|---|
| 46 |
|
|---|
| 47 | <XWorkplace installation folder>\plugins\xcenter\
|
|---|
| 48 |
|
|---|
| 49 | If you are using eCenter (rebranded XCenter included in the latest eComStation
|
|---|
| 50 | releases), copy xsystray.dll to
|
|---|
| 51 |
|
|---|
| 52 | <Boot drive>:\ecs\system\ewps\plugins\xcenter\
|
|---|
| 53 |
|
|---|
| 54 | Then you should close all XCenter instances and start them again. The system
|
|---|
| 55 | tray widget will appear in the widget list under the name "Extended system
|
|---|
| 56 | tray".
|
|---|
| 57 |
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | UPGRADING
|
|---|
| 61 |
|
|---|
| 62 | If you are upgrading from the previous version, you should do the following:
|
|---|
| 63 |
|
|---|
| 64 | - Unlock the old xsystray.dll file (for example, using unlock.exe from the
|
|---|
| 65 | lxlite package).
|
|---|
| 66 | - Overwrite it with the new xsystray.dll file.
|
|---|
| 67 | - Restart WPS. Note that restarting XCenter is not enough since the old DLL
|
|---|
| 68 | will remain loaded in this case.
|
|---|
| 69 |
|
|---|
| 70 | The new version should be now picked up automatically.
|
|---|
| 71 |
|
|---|
| 72 |
|
|---|
| 73 |
|
|---|
| 74 | HISTORY
|
|---|
| 75 |
|
|---|
| 76 | ... unreleased yet ...
|
|---|
| 77 |
|
|---|
| 78 |
|
|---|
| 79 |
|
|---|
| 80 | CREDITS AND COPYRIGHTS
|
|---|
| 81 |
|
|---|
| 82 | This product uses code from the XWorkplace project (c) by Ulrich Moeller.
|
|---|
| 83 |
|
|---|
| 84 | SysTray/WPS is copyright (c) by 1999-2002 OS2.Ru DevTeam.
|
|---|
| 85 | Syswray widget is copyright (c) by Eugene Romanenko.
|
|---|
| 86 |
|
|---|
| 87 | Qt is a trademark of Nokia Corporation and/or its subsidiary(-ies).
|
|---|
| 88 | OS/2 and OS/2 Warp are trademarks of the IBM Corporation and/or its subsidiary(-ies).
|
|---|
| 89 | eComStation is a trademark of Serenity Systems International and/or its subsidiary(-ies).
|
|---|
| 90 |
|
|---|
| 91 | Etc.
|
|---|
| 92 |
|
|---|