This is an old revision of
Tktray from 2005-12-13 03:41:58..
tktray(n) 1.0 tktray "tktray"
tktray - System Tray Icon Support for Tk on X11
package require Tcl 8.4
package require tktray ?1.0?
Tktray is an extension that is able to create system tray icons.
It follows http://www.freedesktop.org
specifications when looking up the system tray
manager. This protocol is supported by modern versions
of KDE and Gnome panels, and by some other panel-like application.
- tktray::icon pathName ?options?
-
Create a new icon for the system tray.
The application managing the system tray is notified about the new icon.
It normally results in the icon being added to the tray.
If there is no system tray at the icon creation time,
the icon will be invisible. When a new system tray appears, the icon will
be added to it.
- -class
-
WM_CLASS attribute for the icon window. Tray manager may use class name
to remember icon position or other attributes.
- -image
-
image to show in the system tray. The value must be the name of a photo image.
Transparency data of the photo are used to set the window's shape.
The icon will be automatically redrawn or resized
appropriately on any image modifications.
- -visible
-
boolean value indicating whether the icon must be visible.
The system tray manager continues to manage the icon whether it is
visible or not. Thus when invisible icon becomes visible, its position
on the system tray is likely to remain the same.
pathName configure ?options?
Modify icon's options after it was created.
An icon behaves like a toplevel window with respect to the
Tk wm and winfo commands.
When -image option is used, the window minimal size and shape
are set using the dimensions and transparency information of the photo
image. wm minsize command may be used to set the minimal icon size
when no image is given. Panel applications obey this setting usually.
Like any toplevel window, the icon may contain widgets.
It's not recommended to build complex GUIs in the system tray. Also note
that the correct handling of the keyboard input is unlikely to be possible.