QSystemTrayIcon Class

Documentation des fonctions membres

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

Construit un objet QSystemTrayIcon avec l'adresse parent.

L'icône est initialement invisible.

Voir également visible.

QSystemTrayIcon::QSystemTrayIcon(const QIcon &icon, QObject *parent = nullptr)

Construit un objet QSystemTrayIcon avec les données icon et parent.

L'icône est initialement invisible.

Voir également visible.

[virtual noexcept] QSystemTrayIcon::~QSystemTrayIcon()

Supprime l'icône de la barre d'état système et libère toutes les ressources allouées.

[signal] void QSystemTrayIcon::activated(QSystemTrayIcon::ActivationReason reason)

Ce signal est émis lorsque l'utilisateur active l'icône de la barre d'état système. reason spécifie la raison de l'activation. QSystemTrayIcon::ActivationReason énumère les différentes raisons.

Voir aussi QSystemTrayIcon::ActivationReason.

QMenu *QSystemTrayIcon::contextMenu() const

Renvoie le menu contextuel actuel pour l'entrée de la barre d'état système.

Voir aussi setContextMenu().

[override virtual protected] bool QSystemTrayIcon::event(QEvent *e)

Réimplémente : QObject::event(QEvent *e).

QRect QSystemTrayIcon::geometry() const

Renvoie la géométrie de l'icône de la barre d'état système en coordonnées d'écran.

Voir aussi visible.

[slot] void QSystemTrayIcon::hide()

Cache l'entrée de la barre d'état système.

Voir aussi show() et visible.

[static] bool QSystemTrayIcon::isSystemTrayAvailable()

Renvoie true si la barre d'état système est disponible ; sinon, il renvoie false.

Si la barre d'état système est actuellement indisponible mais devient disponible plus tard, QSystemTrayIcon ajoutera automatiquement une entrée dans la barre d'état système si elle est visible.

[signal] void QSystemTrayIcon::messageClicked()

Ce signal est émis lorsque l'utilisateur a cliqué sur le message affiché à l'aide de showMessage().

Voir également activated().

void QSystemTrayIcon::setContextMenu(QMenu *menu)

Définit le site menu spécifié comme étant le menu contextuel de l'icône de la barre d'état système.

Le menu apparaîtra lorsque l'utilisateur demandera le menu contextuel de l'icône de la barre d'état système en cliquant sur le bouton de la souris.

Voir aussi contextMenu().

[slot] void QSystemTrayIcon::show()

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

Voir aussi hide() et visible.

[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::Information, int millisecondsTimeoutHint = 10000)

Affiche un message en forme de ballon pour l'entrée correspondant à title, message et icon pour l'heure spécifiée dans millisecondsTimeoutHint. title et message doivent être des chaînes de texte en clair.

Le message peut être cliqué par l'utilisateur ; le signal messageClicked() est émis lorsque cela se produit.

Notez que l'affichage des messages dépend de la configuration du système et des préférences de l'utilisateur, et que les messages peuvent ne pas apparaître du tout. Il ne faut donc pas s'y fier comme au seul moyen de fournir des informations critiques.

Sous Windows, l'adresse millisecondsTimeoutHint est généralement ignorée par le système lorsque l'application est au centre de l'attention.

a été transformé en slot dans Qt 5.2.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        systemTrayIcon, qOverload(&QSystemTrayIcon::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        systemTrayIcon, [receiver = systemTrayIcon](const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon, int millisecondsTimeoutHint) { receiver->showMessage(title, message, icon, millisecondsTimeoutHint); });

Voir aussi show() et supportsMessages().

[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint = 10000)

Affiche un message en forme de ballon pour l'entrée avec les données title, message, et l'icône personnalisée icon pour l'heure spécifiée dans millisecondsTimeoutHint.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        systemTrayIcon, qOverload(&QSystemTrayIcon::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        systemTrayIcon, [receiver = systemTrayIcon](const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint) { receiver->showMessage(title, message, icon, millisecondsTimeoutHint); });

[static] bool QSystemTrayIcon::supportsMessages()

Renvoie true si la barre d'état système prend en charge les messages en forme de ballons ; sinon, renvoie false.

Voir aussi showMessage().