QSystemTrayIcon Class

Documentation des fonctions membres

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

Crée un objet QSystemTrayIcon à partir de l'parent on fournie.

L'icône est initialement invisible.

Voir aussi visible.

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

Crée un objet QSystemTrayIcon avec les paramètres icon et parent fournis.

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. La méthode ` reason ` spécifie la raison de l'activation. La méthode ` QSystemTrayIcon::ActivationReason ` répertorie les différentes raisons.

Voir également QSystemTrayIcon::ActivationReason.

QMenu *QSystemTrayIcon::contextMenu() const

Renvoie le menu contextuel actuel de l'icône 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()

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

Voir également show() et visible.

[static] bool QSystemTrayIcon::isSystemTrayAvailable()

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

Si la barre d’état système n’est pas disponible pour le moment mais le devient ultérieurement, QSystemTrayIcon ajoutera automatiquement une entrée dans la barre d’état système si celle-ci est de type visible.

[signal] void QSystemTrayIcon::messageClicked()

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

Voir également activated().

void QSystemTrayIcon::setContextMenu(QMenu *menu)

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

Le menu s'affichera lorsque l'utilisateur demandera le menu contextuel de l'icône de la barre d'état système en cliquant avec le bouton de la souris.

Voir aussi contextMenu().

[slot] void QSystemTrayIcon::show()

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

Voir également hide() et visible.

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

Affiche une infobulle pour l'entrée dont les paramètres sont les suivants : ` title`, ` message ` et ` icon `, pour la durée spécifiée dans ` millisecondsTimeoutHint`. Les paramètres ` title ` et ` message ` doivent être des chaînes de texte brut.

L'utilisateur peut cliquer sur un message ; le signal messageClicked() est alors émis.

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 s’afficher du tout. Par conséquent, il ne faut pas s’y fier comme seul moyen de fournir des informations critiques.

Sous Windows, le signal ` millisecondsTimeoutHint ` est généralement ignoré par le système lorsque l’application a le focus.

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 également ` show()` et ` supportsMessages()`.

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

Affiche une infobulle pour l'entrée avec l'title, l'message et l'icône personnalisée icon indiqués, pour la durée 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 contextuels ; sinon, renvoie « false ».

Voir également showMessage().