Тип SystemTrayIcon QML

Иконка системного трея. Подробнее...

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

Свойства

• available : bool
• geometry : rect
• icon
  • icon.mask : bool
  • icon.name : string
  • icon.source : url
• menu : Меню
• supportsMessages : bool
• tooltip : string
• visible : bool

Сигналы

• activated(ActivationReason reason)
• messageClicked()

Методы

• void hide()
• void show()
• void showMessage(string title, string message, MessageIcon icon, int msecs)

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

Тип SystemTrayIcon предоставляет иконку приложения в системном трее.

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

Следующий пример показывает, как создать иконку системного трея и как использовать сигнал activated():

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    onActivated: {
        window.show()
        window.raise()
        window.requestActivate()
    }
}

Меню трея

SystemTrayIcon может иметь меню, которое открывается при активации иконки.

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

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    menu: Menu {
        MenuItem {
            text: qsTr("Quit")
            onTriggered: Qt.quit()
        }
    }
}

Сообщения об уведомлениях

SystemTrayIcon может отображать сообщения об уведомлениях.

Следующий пример демонстрирует, как отобразить сообщение об уведомлении с помощью showMessage() и как использовать сигнал messageClicked():

SystemTrayIcon {
    visible: true
    icon.source: "qrc:/images/tray-icon.png"

    onMessageClicked: console.log("Message clicked")
    Component.onCompleted: showMessage("Message title", "Something important came up. Click this to know more.")
}

Доступность

Иконка системного трея в настоящее время доступна на следующих платформах:

• Все менеджеры окон и независимые реализации трея для X11, которые реализуют спецификацию системного трея XEmbed freedesktop.org.
• Все среды рабочего стола, которые реализуют спецификацию freedesktop.org D-Bus StatusNotifierItem, включая последние версии KDE и Unity.
• Все поддерживаемые версии macOS. Обратите внимание, что для отображения сообщений showMessage() на OS X до версии 10.8 (Mountain Lion) необходимо установить систему уведомлений Growl.

Модуль Qt Labs Platform использует Qt Widgets в качестве резервного варианта на платформах, на которых нет нативной реализации. Поэтому приложения, использующие типы из модуля Qt Labs Platform, должны ссылаться на QtWidgets и использовать QApplication вместо QGuiApplication.

Для ссылки на библиотеку QtWidgets добавьте следующее в файл проекта qmake:

QT += widgets

Создайте экземпляр QApplication в main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Примечание: Типы в модулях Qt.labs не гарантируют сохранение совместимости в будущих версиях.

См. также Меню.

Документация по свойствам

[только для чтения] available : bool

Это свойство указывает, доступен ли системный трей.

[с Qt.labs.platform 1.1 (Qt 5.12)] geometry : rect

Это свойство содержит геометрию иконки системного трея.

Это свойство было введено в Qt.labs.platform 1.1 (Qt 5.12).

[с Qt.labs.platform 1.1 (Qt 5.12)] icon.mask : bool

Это свойство содержит иконку системного трея.

SystemTrayIcon {
    icon.mask: true
    icon.source: "qrc:/images/tray-icon.png"
}

Это свойство QML было введено в Qt.labs.platform 1.1 (Qt 5.12).

menu : Меню

Это свойство содержит меню для иконки системного трея.

[только для чтения] supportsMessages : bool

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

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

tooltip : string

Это свойство содержит всплывающую подсказку для иконки системного трея.

visible : bool

Это свойство указывает, отображается ли иконка системного трея.

Значение по умолчанию false.

Документация по сигналам

activated(ActivationReason reason)

Этот сигнал испускается, когда пользователь активирует иконку системного трея. Аргумент reason указывает, как была активирована иконка системного трея.

Доступные причины:

Примечание: Соответствующий обработчик onActivated.

messageClicked()

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

Примечание: Соответствующий обработчик onMessageClicked.

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

Документация по методам

void hide()

Скрывает иконку системного трея.

void show()

Отображает иконку системного трея.

void showMessage(string title, string message, MessageIcon icon, int msecs)

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

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

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