Класс QSystemTrayIcon

Класс QSystemTrayIcon предоставляет значок приложения в системном лотке. Подробнее...

• Список всех членов, включая унаследованные

Открытые типы

Свойства

• icon : QIcon
• toolTip : QString
• visible : bool

Открытые функции

Открытые слоты

Сигналы

Статические открытые члены

Переопределённые защищённые функции

Подробное описание

Современные операционные системы обычно предоставляют специальную область на рабочем столе, называемую системным лотком или областью уведомлений, где долгоживущие приложения могут отображать значки и короткие сообщения.

Класс 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, Интеграция с рабочим столом и Пример значка системного лотка.

Документация типов членов

перечисление QSystemTrayIcon::ActivationReason

Это перечисление описывает причину активации системного лотка.

Примечание: На macOS двойной щелчок будет сгенерирован только если не задано контекстное меню, так как меню открывается при нажатии мыши

См. также activated().

перечисление QSystemTrayIcon::MessageIcon

Это перечисление описывает значок, который отображается при отображении сообщения в виде всплывающего окошка.

См. также QMessageBox.

Документация по членам-функциям

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

Создает объект QSystemTrayIcon со заданным значком icon и родителем parent.

Значок изначально невидим.

См. также visible.

QSystemTrayIcon::QSystemTrayIcon(QObject *parent = nullptr)

Создает объект QSystemTrayIcon со заданным родителем parent.

Значок изначально невидим.

См. также visible.

void QSystemTrayIcon::activated(QSystemTrayIcon::ActivationReason reason)

Этот сигнал излучается, когда пользователь активирует значок системного трея. reason указывает причину активации. QSystemTrayIcon::ActivationReason перечисляет различные причины.

См. также QSystemTrayIcon::ActivationReason.

void QSystemTrayIcon::hide()

Скрывает запись в системном трее.

См. также show() и visible.

void QSystemTrayIcon::messageClicked()

Этот сигнал излучается, когда пользователь нажал на сообщение, отображенное с помощью showMessage(),.

Примечание: Мы следуем поведению Microsoft Windows, поэтому сигнал также излучается, когда пользователь нажимает на значок трея с отображаемым сообщением.

См. также activated().

void QSystemTrayIcon::show()

Отображает значок в системном трее.

См. также hide() и visible.

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.

См. также show() и supportsMessages().

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

Эта функция перегружает showMessage().

Отображает всплывающее сообщение для записи с заданным title, message и настраиваемым значком icon в течение времени, указанного в millisecondsTimeoutHint.

Эта функция была добавлена в Qt 5.9.

QSystemTrayIcon::~QSystemTrayIcon()

Удаляет значок из системного трея и освобождает все выделенные ресурсы.

QMenu *QSystemTrayIcon::contextMenu() const

Возвращает текущее контекстное меню для записи в системном трее.

См. также setContextMenu().

bool QSystemTrayIcon::event(QEvent *e)

Переопределяет: QObject::event(QEvent *e).

QRect QSystemTrayIcon::geometry() const

Возвращает геометрию значка системного трея в координатах экрана.

См. также visible.

bool QSystemTrayIcon::isSystemTrayAvailable()

Возвращает true , если системный трей доступен; в противном случае возвращает false.

Если системный трей в настоящее время недоступен, но становится доступным позже, QSystemTrayIcon автоматически добавит запись в системный трей, если он visible.

void QSystemTrayIcon::setContextMenu(QMenu *menu)

Устанавливает указанное menu в качестве контекстного меню для значка системного трея.

Меню появится, когда пользователь запросит контекстное меню для значка системного трея, щелкнув левой кнопкой мыши.

В macOS это в настоящее время преобразуется в NSMenu, поэтому сигнал aboutToHide() не излучается.

Примечание: Значок системного трея не берет на себя владение меню. Необходимо убедиться, что он удаляется в нужное время, например, создавая меню с соответствующим объектом-родителем.

См. также contextMenu().

bool QSystemTrayIcon::supportsMessages()

Возвращает true , если системный трей поддерживает всплывающие сообщения; в противном случае возвращает false.

См. также showMessage().