QSystemTrayIcon Class

Dokumentation zu den Member-Funktionen

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

Erstellt ein QSystemTrayIcon-Objekt mit dem angegebenen „ parent “.

Das Symbol ist zunächst nicht sichtbar.

Siehe auch ` visible`.

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

Erstellt ein QSystemTrayIcon-Objekt mit den angegebenen Werten für ` icon ` und ` parent`.

Das Symbol ist zunächst unsichtbar.

Siehe auch ` visible`.

[virtual noexcept] QSystemTrayIcon::~QSystemTrayIcon()

Entfernt das Symbol aus der Taskleiste und gibt alle zugewiesenen Ressourcen frei.

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

Dieses Signal wird ausgelöst, wenn der Benutzer das Symbol in der Taskleiste aktiviert. „ reason “ gibt den Grund für die Aktivierung an. Unter QSystemTrayIcon::ActivationReason sind die verschiedenen Gründe aufgeführt.

Siehe auch QSystemTrayIcon::ActivationReason.

QMenu *QSystemTrayIcon::contextMenu() const

Gibt das aktuelle Kontextmenü für den Eintrag in der Taskleiste zurück.

Siehe auch „ setContextMenu()“.

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

Implementiert: ` QObject::event(QEvent *e)`.

QRect QSystemTrayIcon::geometry() const

Gibt die Geometrie des System-Tray-Symbols in Bildschirmkoordinaten zurück.

Siehe auch „ visible “.

[slot] void QSystemTrayIcon::hide()

Blendet den Eintrag in der Taskleiste aus.

Siehe auch show() und visible.

[static] bool QSystemTrayIcon::isSystemTrayAvailable()

Gibt „ true “ zurück, wenn die Taskleiste verfügbar ist; andernfalls wird „ false “ zurückgegeben.

Wenn die Taskleiste derzeit nicht verfügbar ist, später aber verfügbar wird, fügt „ QSystemTrayIcon “ automatisch einen Eintrag in die Taskleiste ein, sofern es sich um „ visible “ handelt.

[signal] void QSystemTrayIcon::messageClicked()

Dieses Signal wird ausgelöst, wenn der Benutzer auf die mit ` showMessage()` angezeigte Meldung geklickt hat.

Siehe auch activated().

void QSystemTrayIcon::setContextMenu(QMenu *menu)

Legt die angegebene Datei „ menu “ als Kontextmenü für das Symbol in der Taskleiste fest.

Das Menü wird angezeigt, wenn der Benutzer durch Klicken mit der Maustaste das Kontextmenü für das Symbol in der Taskleiste aufruft.

Siehe auch ` contextMenu()`

[slot] void QSystemTrayIcon::show()

Zeigt das Symbol in der Taskleiste an.

Siehe auch hide() und visible.

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

Zeigt eine Tooltip-Meldung für den Eintrag mit den angegebenen Werten „ title “, „ message “ und „ icon “ für den in „ millisecondsTimeoutHint “ festgelegten Zeitpunkt an. „ title “ und „ message “ müssen Klartext-Zeichenketten sein.

Der Benutzer kann auf die Meldung klicken; in diesem Fall wird das Signal „ messageClicked()“ ausgelöst.

Beachten Sie, dass die Anzeige von Meldungen von der Systemkonfiguration und den Benutzereinstellungen abhängt und dass Meldungen unter Umständen gar nicht angezeigt werden. Daher sollte man sich nicht ausschließlich darauf verlassen, um wichtige Informationen zu vermitteln.

Unter Windows wird das Signal „ millisecondsTimeoutHint “ vom System in der Regel ignoriert, wenn die Anwendung den Fokus hat.

Wurde in Qt 5.2 in einen Slot umgewandelt.

// 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); });

Siehe auch „ show()“ und „ supportsMessages()“.

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

Zeigt eine Tooltip-Meldung für den Eintrag mit den angegebenen Werten „ title “, „ message “ und dem benutzerdefinierten Symbol „ icon “ für die unter „ millisecondsTimeoutHint “ angegebene Zeit an.

// 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()

Gibt „ true “ zurück, wenn die Taskleiste Balloon-Meldungen unterstützt; andernfalls wird „ false “ zurückgegeben.

Siehe auch showMessage().