Sw4me: Tktray ...

Download tktray sources

NAME

tktray - System Tray Icon Support for Tk on X11

SYNOPSIS

package require Tcl 8.4
package require tktray ?1.0?

DESCRIPTION

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.

COMMANDS

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.

WINDOW MANAGEMENT

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.