A system tray icon. More...
Import Statement: | import Qt.labs.platform 1.0 |
Since: | Qt 5.8 |
Inherits: |
The SystemTrayIcon type provides an icon for an application in the system tray.
Many desktop platforms provide a special system tray or notification area, where applications can display icons and notification messages.
The following example shows how to create a system tray icon, and how to make use of the activated() signal:
SystemTrayIcon { visible: true iconSource: "qrc:/images/tray-icon.png" onActivated: { window.show() window.raise() window.requestActivate() } }
SystemTrayIcon can have a menu that opens when the icon is activated.
The following example illustrates how to assign a Menu to a system tray icon:
SystemTrayIcon { visible: true iconSource: "qrc:/images/tray-icon.png" menu: Menu { MenuItem { text: qsTr("Quit") onTriggered: Qt.quit() } } }
SystemTrayIcon can display notification messages.
The following example presents how to show a notification message using showMessage(), and how to make use of the messageClicked() signal:
SystemTrayIcon { visible: true iconSource: "qrc:/images/tray-icon.png" onMessageClicked: console.log("Message clicked") Component.onCompleted: showMessage("Message title", "Something important came up. Click this to know more.") }
A native system tray icon is currently available on the following platforms:
The Qt Labs Platform module uses Qt Widgets as a fallback on platforms that do not have a native implementation available. Therefore, applications that use types from the Qt Labs Platform module should link to QtWidgets and use QApplication instead of QGuiApplication.
To link against the QtWidgets library, add the following to your qmake project file:
QT += widgets
Create an instance of QApplication in main()
:
#include <QApplication> #include <QQmlApplicationEngine> int main(int argc, char *argv[]) { QApplication::setAttribute(Qt::AA_EnableHighDpiScaling); QApplication app(argc, argv); QQmlApplicationEngine engine; engine.load(QUrl(QStringLiteral("qrc:/main.qml"))); return app.exec(); }
Note: Types in Qt.labs modules are not guaranteed to remain compatible in future versions.
See also Menu.
[read-only] available : bool |
This property holds whether the system tray is available.
iconName : string |
This property holds the theme name of the system tray icon.
See also iconSource and QIcon::fromTheme().
menu : Menu |
This property holds a menu for the system tray icon.
[read-only] supportsMessages : bool |
This property holds whether the system tray icon supports notification messages.
See also showMessage().
tooltip : string |
This property holds the tooltip of the system tray icon.
visible : bool |
This property holds whether the system tray icon is visible.
The default value is false
.
This signal is emitted when the system tray icon is activated by the user. The reason argument specifies how the system tray icon was activated.
Available reasons:
Constant | Description |
---|---|
SystemTrayIcon.Unknown |
Unknown reason |
SystemTrayIcon.Context |
The context menu for the system tray icon was requested |
SystemTrayIcon.DoubleClick |
The system tray icon was double clicked |
SystemTrayIcon.Trigger |
The system tray icon was clicked |
SystemTrayIcon.MiddleClick |
The system tray icon was clicked with the middle mouse button |
This signal is emitted when a notification message is clicked by the user.
See also showMessage().
Shows a system tray message with the given title, message and icon for the time specified in msecs.
Note: System tray messages are dependent on the system configuration and user preferences, and may not appear at all. Therefore, it should not be relied upon as the sole means for providing critical information.
See also supportsMessages and messageClicked().