KSystemTray Class Reference

#include <ksystemtray.h>

Inheritance diagram for KSystemTray:

Public Slots
void	toggleActive ()
void	setActive ()
void	setInactive ()

Signals
void	quitSelected ()

Public Member Functions
	KSystemTray (TQWidget *parent=0, const char *name=0)
TDEPopupMenu *	contextMenu () const
TDEActionCollection *	actionCollection ()
virtual void	setPixmap (const TQPixmap &icon)
virtual void	setCaption (const TQString &title)

Static Public Member Functions
static TQPixmap	loadIcon (const TQString &icon, TDEInstance *instance=TDEGlobal::instance())
static TQPixmap	loadSizedIcon (const TQString &icon, int iconWidth, TDEInstance *instance=TDEGlobal::instance())

Protected Member Functions
void	mousePressEvent (TQMouseEvent *)
void	mouseReleaseEvent (TQMouseEvent *)
virtual void	contextMenuAboutToShow (TDEPopupMenu *menu)
void	showEvent (TQShowEvent *)
void	enterEvent (TQEvent *)
virtual void	virtual_hook (int id, void *data)

Detailed Description

KDE System Tray Window class

This class implements system tray windows.

A tray window is a small window (typically 24x24 pixel) that docks into the system tray in the desktop panel. It usually displays an icon or an animated icon there. The icon represents the application, similar to a taskbar button, but consumes less screen space.

When the user clicks with the left mouse button on the icon, the main application window is shown/raised and activated. With the right mouse button, she gets a popupmenu with application specific commands, including "Minimize/Restore" and "Quit".

Docking happens magically when calling show(). The window undocks with either hide() or when it is destroyed.

KSystemTray inherits methods such as setPixmap() and setMovie() to specify an icon or movie (animated icon) respectively. It is designed to be usable "as is", without the need to subclass it. In case you need to provide something special (such as an additional popupmenu on a click with the left mouse button), you can subclass anyway, of course.

Having an icon on the system tray is a useful technique for daemon-like applications that may run for some time without user interaction but have to be there immediately when the user needs them. Examples are kppp, kisdn, kscd, kmix or knotes. With kppp and kisdn, the docked icon even provides real-time information about the network status.

Author

Matthias Ettrich ettri.nosp@m.ch@k.nosp@m.de.or.nosp@m.g

Definition at line 63 of file ksystemtray.h.

Constructor & Destructor Documentation

KSystemTray()

KSystemTray::KSystemTray	(	TQWidget *	parent = 0,
		const char *	name = 0
	)

Construct a KSystemTray widget just like any other widget.

The parent widget parent has a special meaning: Besides owning the tray window, the parent widget will dissappear from taskbars when it is iconified while the tray window is visible. This is the desired behavior. After all, the tray window is the parent's taskbar icon.

Furthermore, the parent widget is shown or raised respectively when the user clicks on the trray window with the left mouse button.

Definition at line 61 of file ksystemtray.cpp.

Member Function Documentation

actionCollection()

TDEActionCollection * KSystemTray::actionCollection

(

)

Easy access to the actions in the context menu Currently includes KStdAction::Quit and minimizeRestore.

Since

3.1

Definition at line 310 of file ksystemtray.cpp.

contextMenu()

TDEPopupMenu * KSystemTray::contextMenu

(

)

const

Access to the context menu.

This makes it easy to add new items to it.

Definition at line 139 of file ksystemtray.cpp.

contextMenuAboutToShow()

void KSystemTray::contextMenuAboutToShow ( TDEPopupMenu *  menu )

protectedvirtual

Makes it easy to adjust some menu items right before the context menu becomes visible.

Definition at line 178 of file ksystemtray.cpp.

enterEvent()

void KSystemTray::enterEvent ( TQEvent *  e )

protected

Reimplemented for internal reasons.

Definition at line 134 of file ksystemtray.cpp.

loadIcon()

TQPixmap KSystemTray::loadIcon ( const TQString &  icon, TDEInstance *  instance = TDEGlobal::instance()  )

static

Loads an icon icon using the icon loader class of the given instance instance.

The icon is applied the panel effect as it should only be used to be shown in the system tray. It's commonly used in the form : systray->setPixmap( systray->loadIcon( "mysystray" ) );

Since

3.2

Definition at line 315 of file ksystemtray.cpp.

loadSizedIcon()

TQPixmap KSystemTray::loadSizedIcon ( const TQString &  icon, int  iconWidth, TDEInstance *  instance = TDEGlobal::instance()  )

static

Loads an icon icon using the icon loader class of the given instance instance.

The icon is applied the panel effect as it should only be used to be shown in the system tray. It's commonly used in the form : systray->setPixmap( systray->loadIcon( "mysystray", iconWidth ) ); This is essentially the same as loadIcon(), but with a forced icon size

Since

3.5.12

Definition at line 323 of file ksystemtray.cpp.

mousePressEvent()

void KSystemTray::mousePressEvent ( TQMouseEvent *  e )

protected

Reimplemented to provide the standard show/raise behavior for the parentWidget() and the context menu.

Feel free to reimplement this if you need something special.

Definition at line 145 of file ksystemtray.cpp.

mouseReleaseEvent()

void KSystemTray::mouseReleaseEvent ( TQMouseEvent *  )

protected

Reimplemented to provide the standard show/raise behavior for the parentWidget() and the context menu.

Feel free to reimplement this if you need something special.

Definition at line 173 of file ksystemtray.cpp.

quitSelected

void KSystemTray::quitSelected ( )

signal

Emitted when quit is selected in the menu.

If you want to perform any other action than to close the main application window please connect to this signal.

Since

3.1

setActive

void KSystemTray::setActive ( )

slot

Activates the window associated with this system tray icon, regardless of its current state.

Since

3.3

Definition at line 227 of file ksystemtray.cpp.

setCaption()

void KSystemTray::setCaption ( const TQString &  title )

virtual

Changes the tray's text description (which can be seen e.g.

in the systray configuration dialog). The default value is TDEAboutData::programName().

Definition at line 341 of file ksystemtray.cpp.

setInactive

void KSystemTray::setInactive ( )

slot

Hides the window associated with this system tray icon, regardless of its current state.

Since

3.3

Definition at line 232 of file ksystemtray.cpp.

setPixmap()

void KSystemTray::setPixmap ( const TQPixmap &  icon )

virtual

Changes the tray's icon.

Definition at line 328 of file ksystemtray.cpp.

showEvent()

void KSystemTray::showEvent ( TQShowEvent *  )

protected

Reimplemented for internal reasons.

Definition at line 111 of file ksystemtray.cpp.

toggleActive

void KSystemTray::toggleActive ( )

slot

Toggles the state of the window associated with this system tray icon (hides it, shows it or activates it depending on the window state).

The default implementation of mousePressEvent() calls toggleActive() when the tray icon is left-clicked, use it when reimplementing mousePressEvent().

Since

3.3

Definition at line 222 of file ksystemtray.cpp.

---

The documentation for this class was generated from the following files:

• ksystemtray.h
• ksystemtray.cpp