SystemTrayIcon QML Type

Ein Symbol für die Systemablage. Mehr...

• Liste aller Mitglieder, einschließlich geerbter 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)

Detaillierte Beschreibung

Der Typ SystemTrayIcon stellt ein Symbol für eine Anwendung im Systemtray bereit.

Viele Desktop-Plattformen bieten einen speziellen Systemtray oder Benachrichtigungsbereich, in dem Anwendungen Symbole und Benachrichtigungen anzeigen können.

Das folgende Beispiel zeigt, wie man ein System-Tray-Icon erstellt und wie man das activated()-Signal verwendet:

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

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

Tray Menü

SystemTrayIcon kann ein Menü haben, das sich öffnet, wenn das Symbol aktiviert wird.

Das folgende Beispiel zeigt, wie man einem SystemTrayIcon ein Menu zuweisen kann:

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

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

Benachrichtigungsmeldungen

SystemTrayIcon kann Benachrichtigungsmeldungen anzeigen.

Das folgende Beispiel zeigt, wie man eine Benachrichtigung mit showMessage() anzeigt, und wie man das messageClicked() Signal verwendet:

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 System Tray Icon ist derzeit available auf den folgenden Plattformen verfügbar:

• Alle Fenstermanager und unabhängigen Tray-Implementierungen für X11, die die freedesktop.org XEmbed-Systemtray-Spezifikation implementieren.
• Alle Desktop-Umgebungen, die die freedesktop.org D-Bus StatusNotifierItem-Spezifikation 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() Nachrichten unter OS X vor 10.8 (Mountain Lion) anzeigt.

Das Modul Qt Labs Platform verwendet Qt Widgets als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Qt Labs Platform Modul verwenden, mit QtWidgets verknüpft werden und QApplication anstelle von QGuiApplication verwenden.

Um gegen die QtWidgets-Bibliothek zu linken, fügen Sie das Folgende zu Ihrer qmake-Projektdatei hinzu:

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.

Eigenschaft Dokumentation

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

Signal Dokumentation

Methode Dokumentation