系统托盘图标 QML 类型

系统托盘图标。 更多信息...

• 所有成员的列表，包括继承的成员

属性

• available : bool
• geometry : rect (自 Qt.labs.platform 1.1 (Qt 5.12)起)
• icon (自 Qt.labs.platform 1.1 (Qt 5.12)起)
  • icon.mask : bool (自 Qt.labs.platform 1.1 (Qt 5.12)起)
  • icon.name : string (自 Qt.labs.platform 1.1 (Qt 5.12)起)
  • icon.source : url (自 Qt.labs.platform 1.1 (Qt 5.12)起)
• menu : 菜单
• supportsMessages : bool
• tooltip : string
• visible : bool

信号

• activated(激活原因 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 可以有一个在图标激活时打开的菜单。

以下示例说明了如何将 Menu 赋值给系统托盘图标

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.")
}

可用性

原生系统托盘图标目前在以下平台可用

• 所有实现了freedesktop.org XEmbed系统托盘规范的X11窗口管理器和独立托盘实现。
• 所有实现了freedesktop.org D-Bus StatusNotifierItem规范的桌面环境，包括最近的KDE和Unity版本。
• 所有支持的macOS版本。请注意，在OS X 10.8（山狮）之前的版本中显示消息之前，必须安装Growl通知系统。

Qt Labs平台模块在平台没有可用原生实现的情况下使用Qt Widgets作为后备。因此，使用Qt Labs平台模块的类型的应用程序应该链接到QtWidgets，并使用QApplication而不是QGuiApplication。

要将对QtWidgets库的链接添加到您的qmake项目文件中，请按以下操作进行

QT += widgets

在主函数（main()）中实例化QApplication

#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();
}

另请参阅：菜单。

属性文档

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

信号文档

方法文档