SystemTrayIcon QML Type

Ein Symbol in der Taskleiste. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• available : bool
• geometry : rect (since Qt.labs.platform 1.1 (Qt 5.12))
• icon (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.mask : bool (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.name : string (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.source : url (since Qt.labs.platform 1.1 (Qt 5.12))
• menu : Menu
• supportsMessages : bool
• tooltip : string
• visible : bool

Signale

• activated(ActivationReason reason)
• messageClicked()

Methoden

• void hide()
• void show()
• void showMessage(string title, string message, MessageIcon icon, int msecs)

Ausführliche Beschreibung

Der Typ „SystemTrayIcon“ stellt ein Symbol für eine Anwendung in der Taskleiste bereit.

Viele Desktop-Plattformen verfügen über einen speziellen System-Tray oder einen Benachrichtigungsbereich, in dem Anwendungen Symbole und Benachrichtigungen anzeigen können.

Das folgende Beispiel zeigt, wie man ein Symbol in der Taskleiste erstellt und wie man das Signal „ activated()“ nutzt:

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    onActivated: {
        window.show()
        window.raise()
        window.requestActivate()
    }
}

Tray-Menü

„SystemTrayIcon“ kann über ein Menü verfügen, das sich öffnet, wenn das Symbol aktiviert wird.

Das folgende Beispiel veranschaulicht, wie man einem Symbol in der Taskleiste ein „ Menu “ zuweist:

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    menu: Menu {
        MenuItem {
            text: qsTr("Quit")
            onTriggered: Qt.quit()
        }
    }
}

Benachrichtigungen

SystemTrayIcon kann Benachrichtigungen anzeigen.

Das folgende Beispiel zeigt, wie man mithilfe von ` showMessage()` eine Benachrichtigung anzeigt und wie man das Signal ` messageClicked()` nutzt:

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    onMessageClicked: console.log("Message clicked")
    Component.onCompleted: showMessage("Message title", "Something important came up. Click this to know more.")
}

Verfügbarkeit

Ein natives Taskleisten-Symbol ist derzeit auf den folgenden Plattformen als „ available “ verfügbar:

• Alle Fenstermanager und unabhängigen System-Tray-Implementierungen für X11, die die freedesktop.org-Spezifikation „XEmbed System Tray“ implementieren.
• Alle Desktop-Umgebungen, die die freedesktop.org-Spezifikation „D-Bus StatusNotifierItem“ implementieren, einschließlich aktueller Versionen von KDE und Unity.
• Alle unterstützten Versionen von macOS. Beachten Sie, dass das Growl-Benachrichtigungssystem installiert sein muss, damit „ showMessage()“ unter OS X vor Version 10.8 (Mountain Lion) Meldungen anzeigen kann.

Das Modul „ Qt Labs Platform “ verwendet „ Qt Widgets “ als Fallback auf Plattformen, auf denen keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Modul „ Qt Labs Platform “ verwenden, einen Link zu „ QtWidgets “ herstellen und „ QApplication “ anstelle von „ QGuiApplication “ verwenden.

Um eine Verknüpfung mit der Bibliothek „ QtWidgets “ herzustellen, fügen Sie Folgendes in Ihre qmake-Projektdatei ein:

QT += widgets

Erstellen Sie eine Instanz von „ QApplication “ in „ main() “:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Siehe auch „ Menu “.

Dokumentation zu den Eigenschaften

available : bool [read-only]

Diese Eigenschaft gilt unabhängig davon, ob die Taskleiste verfügbar ist.

geometry : rect [since Qt.labs.platform 1.1 (Qt 5.12)]

Diese Eigenschaft enthält die Geometrie des Symbols in der Taskleiste.

Diese Eigenschaft wurde in Qt Labs Platform 1.1 (Qt 5.12) eingeführt.

icon group

Diese Eigenschaft enthält das Symbol in der Taskleiste.

SystemTrayIcon {
    icon.mask: true
    icon.source: "qrc:/images/tray-icon.png"
}

Diese Eigenschaften wurden in Qt Labs Platform 1.1 (Qt 5.12) eingeführt.

menu : Menu

Diese Eigenschaft enthält ein Menü für das Symbol in der Taskleiste.

supportsMessages : bool [read-only]

Diese Eigenschaft gibt an, ob das Symbol in der Taskleiste Benachrichtigungen unterstützt.

Siehe auch „ showMessage()“.

tooltip : string

Diese Eigenschaft enthält den Tooltip des Symbols in der Taskleiste.

visible : bool

Diese Eigenschaft legt fest, ob das Symbol in der Taskleiste sichtbar ist.

Der Standardwert lautet „ false “.

Signal-Dokumentation

activated(ActivationReason reason)

Dieses Signal wird ausgelöst, wenn das Symbol in der Taskleiste vom Benutzer aktiviert wird. Das Argument „ reason “ gibt an, wie das Symbol in der Taskleiste aktiviert wurde.

Mögliche Gründe:

messageClicked()

Dieses Signal wird ausgelöst, wenn der Benutzer auf eine Benachrichtigung klickt.

Siehe auch ` showMessage()`.

Methodendokumentation

void hide()

Blendet das Symbol in der Taskleiste aus.

void show()

Zeigt das Symbol in der Taskleiste an.

void showMessage(string title, string message, MessageIcon icon, int msecs)

Zeigt eine Taskleistenmeldung mit den angegebenen Werten für „ title “, „ message “ und „ icon “ für den unter „ msecs “ festgelegten Zeitpunkt an.

Siehe auch supportsMessages und messageClicked().