SystemTrayIcon QML Type

Icône de la barre d'état système. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Signaux

• activated(ActivationReason reason)
• messageClicked()

Méthodes

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

Description détaillée

Le type SystemTrayIcon fournit une icône pour une application dans la barre d'état système.

De nombreuses plates-formes de bureau fournissent une zone de notification ou une barre d'état système spéciale, dans laquelle les applications peuvent afficher des icônes et des messages de notification.

L'exemple suivant montre comment créer une icône de barre d'état système et comment utiliser le signal activated() :

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

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

Menu de la barre d'état système

SystemTrayIcon peut avoir un menu qui s'ouvre lorsque l'icône est activée.

L'exemple suivant montre comment attribuer une adresse Menu à une icône de la barre d'état système :

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

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

Messages de notification

SystemTrayIcon peut afficher des messages de notification.

L'exemple suivant montre comment afficher un message de notification à l'aide de showMessage() et comment utiliser le signal messageClicked() :

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.")
}

Disponibilité

L'icône native de la barre d'état système est actuellement disponible à l'adresse available sur les plates-formes suivantes :

• Tous les gestionnaires de fenêtres et les implémentations indépendantes de la barre d'état système pour X11 qui implémentent la spécification XEmbed de la barre d'état système de freedesktop.org.
• Tous les environnements de bureau qui implémentent la spécification D-Bus StatusNotifierItem de freedesktop .org, y compris les versions récentes de KDE et Unity.
• Toutes les versions prises en charge de macOS. Notez que le système de notification Growl doit être installé pour que showMessage() affiche des messages sur OS X antérieur à 10.8 (Mountain Lion).

Le module Qt Labs Platform utilise Qt Widgets comme solution de repli sur les plateformes qui ne disposent pas d'une implémentation native. Par conséquent, les applications qui utilisent des types du module Qt Labs Platform doivent être liées à QtWidgets et utiliser QApplication au lieu de QGuiApplication.

Pour établir un lien avec la bibliothèque QtWidgets, ajoutez ce qui suit à votre fichier de projet qmake :

QT += widgets

Créez une instance de QApplication dans 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();
}

Voir aussi Menu.

Documentation sur les propriétés

available : bool [read-only]

Cette propriété indique si la barre d'état système est disponible.

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

Cette propriété contient la géométrie de l'icône de la barre d'état système.

Cette propriété a été introduite dans Qt.Labs.Platform 1.1 (Qt 5.12).

icon group

Cette propriété contient l'icône de la barre d'état système.

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

Ces propriétés ont été introduites dans Qt.labs.platform 1.1 (Qt 5.12).

menu : Menu

Cette propriété contient un menu pour l'icône de la barre d'état système.

supportsMessages : bool [read-only]

Cette propriété indique si l'icône de la barre d'état système prend en charge les messages de notification.

Voir aussi showMessage().

tooltip : string

Cette propriété contient l'info-bulle de l'icône de la barre d'état système.

visible : bool

Cette propriété indique si l'icône de la barre d'état système est visible.

La valeur par défaut est false.

Documentation sur le signal

activated(ActivationReason reason)

Ce signal est émis lorsque l'icône de la barre d'état système est activée par l'utilisateur. L'argument reason indique comment l'icône de la barre d'état système a été activée.

Motifs disponibles :

messageClicked()

Ce signal est émis lorsque l'utilisateur clique sur un message de notification.

Voir également showMessage().

Documentation de la méthode

void hide()

Masque l'icône de la barre d'état système.

void show()

Affiche l'icône de la barre d'état système.

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

Affiche un message dans la barre d'état système avec les données title, message et icon pour la durée spécifiée dans msecs.

Voir également supportsMessages et messageClicked().