Класс QSystemTrayIcon
Класс QSystemTrayIcon предоставляет значок приложения в системном трее. Подробнее...
| Заголовок: | #include <QSystemTrayIcon> |
| qmake: | QT += widgets |
| С момента: | Qt 4.2 |
| Наследуется от: | QObject |
Этот класс был представлен в Qt 4.2.
Типы публичного доступа
| перечисление | ActivationReason { Unknown, Context, DoubleClick, Trigger, MiddleClick } |
| перечисление | MessageIcon { NoIcon, Information, Warning, Critical } |
Свойства
Публичные функции
| QSystemTrayIcon(const QIcon &icon, QObject *parent = nullptr) | |
| QSystemTrayIcon(QObject *parent = nullptr) | |
| виртуальный | ~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 |
Свойства публичного доступа
| 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() |
Статические публичные члены
| bool | isSystemTrayAvailable() |
| bool | supportsMessages() |
Переопределенные защищенные функции
| виртуальный 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 автоматически добавит запись в системный лоток, если он visible.
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.13/qsystemtrayicon.html
