Класс 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, включая последние версии KDE и Unity. http://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/StatusNotifierItem
• Все поддерживаемые версии 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().