Класс QSystemTrayIcon
Класс QSystemTrayIcon предоставляет значок приложения в системном трее. Подробнее...
| Заголовок: | #include <QSystemTrayIcon> |
| qmake: | QT += widgets |
| С момента: | Qt 4.2 |
| Наследует: | QObject |
Этот класс был представлен в Qt 4.2.
Типы Public
| Перечисление | ActivationReason { Unknown, Context, DoubleClick, Trigger, MiddleClick } |
| Перечисление | MessageIcon { NoIcon, Information, Warning, Critical } |
Свойства
Функции Public
| QSystemTrayIcon(const QIcon &icon, QObject *parent = nullptr) | |
| QSystemTrayIcon(QObject *parent = nullptr) | |
| virtual | ~QSystemTrayIcon() |
| QMenu * | contextMenu() const |
| QRect | geometry() const |
| QIcon | icon() const |
| bool | isVisible() const |
| void | setContextMenu(QMenu *menu) |
| void | setIcon(const QIcon &icon) |
| void | setToolTip(const QString &tip) |
| QString | toolTip() const |
Свойства Public
| void | hide() |
| void | setVisible(bool visible) |
| void | show() |
| void | showMessage(const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::Information, int millisecondsTimeoutHint = 10000) |
| void | showMessage(const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint = 10000) |
Сигналы
| void | activated(QSystemTrayIcon::ActivationReason reason) |
| void | messageClicked() |
Статические члены Public
| bool | isSystemTrayAvailable() |
| bool | supportsMessages() |
Переопределенные защищенные функции
| virtual bool | event(QEvent *e) override |
Подробное описание
Современные операционные системы обычно предоставляют специальную область на рабочем столе, называемую системным треем или областью уведомлений, где долго выполняющиеся приложения могут отображать значки и короткие сообщения.
Класс QSystemTrayIcon может использоваться на следующих платформах:
- Все поддерживаемые версии Windows.
- Все диспетчеры окон и независимые реализации трея для X11, которые реализуют спецификацию системного трея XEmbed http://standards.freedesktop.org/systemtray-spec/systemtray-spec-0.2.html freedesktop.org.
- Все среды рабочего стола X11, которые реализуют спецификацию D-Bus http://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/StatusNotifierItem, включая последние версии KDE и Unity.
- Все поддерживаемые версии macOS.
Чтобы проверить наличие системного трея на рабочем столе пользователя, вызовите статический метод QSystemTrayIcon::isSystemTrayAvailable().
Для добавления записи в системный трей создайте объект QSystemTrayIcon, вызовите setContextMenu() для предоставления контекстного меню для значка и вызовите show() для его отображения в системном трее. Сообщения об уведомлениях статуса («шарики сообщений») могут отображаться в любое время с помощью showMessage().
Если системный трей недоступен при создании значка системного трея, но становится доступным позже, QSystemTrayIcon автоматически добавит запись для приложения в системный трей, если значок visible.
Сигнал activated() генерируется, когда пользователь активирует значок.
Только на X11, когда запрашивается всплывающая подсказка, QSystemTrayIcon получает QHelpEvent типа QEvent::ToolTip. Кроме того, QSystemTrayIcon получает колесо мыши событий типа QEvent::Wheel. Эти события не поддерживаются на других платформах.
См. также QDesktopServices, QDesktopWidget, Интеграция в Рабочий стол и Пример значка системного трея.
Документация типов членов
Перечисление QSystemTrayIcon::ActivationReason
Это перечисление описывает причину активации системного трея.
| Константа | Значение | Описание |
|---|---|---|
QSystemTrayIcon::Unknown |
0 |
Неизвестная причина |
QSystemTrayIcon::Context |
1 |
Было запрошено контекстное меню для записи в системном трее |
QSystemTrayIcon::DoubleClick |
2 |
Запись в системном трее была дважды нажата. |
Примечание: В macOS, двойной щелчок будет сгенерирован только если не установлено контекстное меню, так как меню открывается при нажатии
| Константа | Значение | Описание |
|---|---|---|
QSystemTrayIcon::Trigger |
3 |
Запись в системном трее была щелкнута |
QSystemTrayIcon::MiddleClick |
4 |
Запись в системном трее была нажата средней кнопкой мыши |
См. также activated().
Перечисление QSystemTrayIcon::MessageIcon
Это перечисление описывает значок, отображаемый при отображении сообщения-шарика.
| Константа | Значение | Описание |
|---|---|---|
QSystemTrayIcon::NoIcon |
0 |
Значок не отображается. |
QSystemTrayIcon::Information |
1 |
Отображается значок информации. |
QSystemTrayIcon::Warning |
2 |
Отображается стандартный значок предупреждения. |
QSystemTrayIcon::Critical |
3 |
Отображается значок критического предупреждения. |
См. также QMessageBox.
Документация по свойствам
icon : QIcon
Это свойство содержит значок системного трея.
В Windows размер значка системного трея составляет 16x16; в X11 предпочтительный размер составляет 22x22. Значок будет масштабироваться до соответствующего размера по необходимости.
Функции доступа:
| QIcon | icon() const |
| void | setIcon(const QIcon &icon) |
toolTip : QString
Это свойство содержит всплывающую подсказку для записи в системном трее.
В некоторых системах длина всплывающей подсказки ограничена. Всплывающая подсказка будет обрезана при необходимости.
Функции доступа:
| QString | toolTip() const |
| void | setToolTip(const QString &tip) |
visible : bool
Это свойство указывает, отображается ли запись в системном трее.
Установление этого свойства в значение true или вызов show() делает значок системного трея видимым; установка этого свойства в значение false или вызов hide() скрывает его.
Функции доступа:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Документация по членам-функциям
QSystemTrayIcon::QSystemTrayIcon(const QIcon &icon, QObject *parent = nullptr)
Создает объект QSystemTrayIcon с заданным значком icon и родителем parent.
Значок изначально невидим.
См. также visible.
QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)
Создает объект QSystemTrayIcon с заданным родителем parent.
Значок изначально невидим.
См. также visible.
[signal] void QSystemTrayIcon::activated(QSystemTrayIcon::ActivationReason reason)
Этот сигнал излучается, когда пользователь активирует значок системного трея. reason указывает причину активации. QSystemTrayIcon::ActivationReason перечисляет различные причины.
См. также QSystemTrayIcon::ActivationReason.
[slot] void QSystemTrayIcon::hide()
Скрывает запись в системном трее.
[signal] void QSystemTrayIcon::messageClicked()
Этот сигнал излучается, когда пользователь нажимает на сообщение, отображенное с помощью showMessage().
В настоящее время этот сигнал не отправляется на macOS.
Примечание: Мы следуем поведению Microsoft Windows, поэтому сигнал также излучается, когда пользователь нажимает на значок трея с отображенным сообщением-балуном.
См. также activated().
[slot] void QSystemTrayIcon::show()
Отображает значок в системном трее.
[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::Information, int millisecondsTimeoutHint = 10000)
Отображает сообщение-балун для записи с заданным title, message и icon на указанное время в millisecondsTimeoutHint. title и message должны быть обычными строками текста.
Пользователь может нажать на сообщение; сигнал messageClicked() будет излучен, когда это произойдет.
Обратите внимание, что отображение сообщений зависит от конфигурации системы и пользовательских настроек, и сообщения могут вообще не отображаться. Поэтому на него не следует полагаться как на единственный способ предоставления критической информации.
В Windows значение millisecondsTimeoutHint обычно игнорируется системой, когда приложение имеет фокус.
Преобразован в слот в Qt 5.2.
Эта функция была введена в Qt 4.3.
См. также show() и supportsMessages().
[slot] void QSystemTrayIcon::showMessage(const QString &title, const QString &message, const QIcon &icon, int millisecondsTimeoutHint = 10000)
Эта функция перегружает showMessage().
Отображает сообщение-балун для записи с заданным title, message и пользовательским значком icon на указанное время в millisecondsTimeoutHint.
Эта функция была введена в Qt 5.9.
[virtual] QSystemTrayIcon::~QSystemTrayIcon()
Удаляет значок из системного трея и освобождает все выделенные ресурсы.
QMenu *QSystemTrayIcon::contextMenu() const
Возвращает текущее контекстное меню для записи в системном трее.
См. также setContextMenu().
[override virtual protected] bool QSystemTrayIcon::event(QEvent *e)
Переопределяет: QObject::event(QEvent *e).
QRect QSystemTrayIcon::geometry() const
Возвращает геометрию значка системного трея в координатах экрана.
Эта функция была введена в Qt 4.3.
См. также visible.
[static] bool QSystemTrayIcon::isSystemTrayAvailable()
Возвращает true если системный трей доступен; в противном случае возвращает false.
Если системный трей в настоящее время недоступен, но становится доступным позже, QSystemTrayIcon автоматически добавит запись в системный трей, если она видима.
void QSystemTrayIcon::setContextMenu(QMenu *menu)
Устанавливает указанное menu в качестве контекстного меню для значка системного трея.
Меню будет отображаться, когда пользователь запросит контекстное меню для значка системного трея, щелкнув мышью.
В macOS это в настоящее время преобразуется в NSMenu, поэтому сигнал aboutToHide() не излучается.
Примечание: значок системного трея не берет владения меню. Вы должны убедиться, что оно удалено в соответствующее время, например, создавая меню с соответствующим родительским объектом.
См. также contextMenu().
[static] bool QSystemTrayIcon::supportsMessages()
Возвращает true если системный трей поддерживает сообщения-балуны; в противном случае возвращает false.
См. также showMessage().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qsystemtrayicon.html
