KDEUI
#include <ksystemtrayicon.h>
Public Slots | |
void | toggleActive () |
Signals | |
void | quitSelected () |
Public Member Functions | |
KSystemTrayIcon (QWidget *parent=0) | |
KSystemTrayIcon (const QString &icon, QWidget *parent=0) | |
KSystemTrayIcon (const QIcon &icon, QWidget *parent=0) | |
KSystemTrayIcon (QMovie *movie, QWidget *parent) | |
~KSystemTrayIcon () | |
KActionCollection * | actionCollection () |
QAction * | contextMenuTitle () const |
const QMovie * | movie () const |
QWidget * | parentWidget () const |
bool | parentWidgetTrayClose () const |
void | setContextMenuTitle (QAction *action) |
void | setMovie (QMovie *movie) |
Static Public Member Functions | |
static QIcon | loadIcon (const QString &icon, const KComponentData &componentData=KGlobal::mainComponent()) |
Detailed Description
KDE System Tray Window class
This class implements system tray windows.
A tray window is a small window (typically 22x22 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".
Please note that this class is being phased out in favor of the KStatusNotifierItem class, you should consider to use it instead if you are writing a new application or consider porting the code that uses this class to the KStatusNotifierItem API.
Also, QSystemTrayIcon::showMessage(..) should not be used for KDE application because the popup message has no KDE standard look & feel and cannot be controlled by KDE configurations. Use KNotification or KPassivePopup instead.
Definition at line 60 of file ksystemtrayicon.h.
Constructor & Destructor Documentation
|
explicit |
Construct a system tray icon.
The parent widget parent
has a special meaning: Besides owning the tray window, the parent widget will disappear 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 tray window with the left mouse button.
Definition at line 111 of file ksystemtrayicon.cpp.
Same as above but allows one to define the icon by name that should be used for the system tray icon.
Definition at line 118 of file ksystemtrayicon.cpp.
|
explicit |
Same as above but allows one to define the icon by name that should be used for the system tray icon.
Definition at line 125 of file ksystemtrayicon.cpp.
|
explicit |
Same as above but allows one to define the movie by QMovie that should be used for the system tray icon.
Memory management for the movie will be handled by KSystemTrayIcon.
Definition at line 132 of file ksystemtrayicon.cpp.
KSystemTrayIcon::~KSystemTrayIcon | ( | ) |
Destructor.
Definition at line 180 of file ksystemtrayicon.cpp.
Member Function Documentation
KActionCollection * KSystemTrayIcon::actionCollection | ( | ) |
Easy access to the actions in the context menu Currently includes KStandardAction::Quit and minimizeRestore.
Definition at line 354 of file ksystemtrayicon.cpp.
QAction * KSystemTrayIcon::contextMenuTitle | ( | ) | const |
|
static |
Loads an icon icon
using the icon loader class of the given componentData componentData
.
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" ) );
Definition at line 359 of file ksystemtrayicon.cpp.
const QMovie * KSystemTrayIcon::movie | ( | ) | const |
Get a pointer to the movie.
Use this pointer to manipulate the movie (start, stop, pause). Will return null if no movie has been set
- Since
- 4.2
Definition at line 403 of file ksystemtrayicon.cpp.
QWidget * KSystemTrayIcon::parentWidget | ( | ) | const |
Returns the QWidget set by the constructor.
Definition at line 175 of file ksystemtrayicon.cpp.
bool KSystemTrayIcon::parentWidgetTrayClose | ( | ) | const |
Function to be used from function handling closing of the window associated with the tray icon (i.e.
QWidget::closeEvent(), KMainWindow::queryClose() or similar). When false is returned, the window closing should proceed normally, when true is returned, special systray-related handling should take place.
Definition at line 371 of file ksystemtrayicon.cpp.
|
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.
void KSystemTrayIcon::setContextMenuTitle | ( | QAction * | action | ) |
Sets the context menu title action to action
.
The following code shows how to change the current title. QAction *titleAction = contextMenuTitle(); titleAction->setText("New Title"); setContextMenuTitle(titleAction);
- Since
- 4.1
Definition at line 378 of file ksystemtrayicon.cpp.
void KSystemTrayIcon::setMovie | ( | QMovie * | movie | ) |
Set the movie to use.
To manipulate the movie (start, stop, pause), call
- See also
- movie() and make calls on the QMovie* that it returns. Memory management for the movie will be handled by KSystemTrayIcon.
- Since
- 4.2
Definition at line 391 of file ksystemtrayicon.cpp.
|
slot |
Definition at line 366 of file ksystemtrayicon.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2014 The KDE developers.
Generated on Tue Oct 14 2014 22:49:18 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.