SystemTrayIcon QML Type

系统托盘图标更多

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

属性

• available : bool
• geometry : rect (since Qt.labs.platform 1.1 (Qt 5.12))
• icon (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.mask : bool (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.name : string (since Qt.labs.platform 1.1 (Qt 5.12))
  • icon.source : url (since Qt.labs.platform 1.1 (Qt 5.12))
• menu : 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 可以有一个菜单，在图标被激活时打开。

下面的示例说明了如何为系统托盘图标分配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.")
}

可用性

本机系统托盘图标目前可在以下平台上使用available ：

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

在没有本地实现的平台上，Qt Labs Platform 模块使用Qt Widgets 作为备用。因此，使用Qt Labs Platform 模块中类型的应用程序应链接到 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();
}

另请参阅 Menu 。

属性文档

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

信号文档

方法文档