16、QSystemTrayIcon 系统托盘控件

原创已于 2022-09-20 23:05:50 修改 · 840 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#引用传递 #c++ #asp.net

于 2019-10-20 14:37:22 首次发布

QT入门教程专栏收录该内容

42 篇文章

订阅专栏

本文详细介绍了QSystemTrayIcon类的使用方法，包括如何检查系统托盘的可用性，如何创建和显示系统托盘图标，如何设置上下文菜单，以及如何处理用户交互事件。同时，还提供了枚举类型、信号和槽函数的说明，以及一个完整的示例代码。

简述

QSystemTrayIcon类为应用程序在系统托盘中提供一个图标。

现代操作系统通常在桌面上提供一个特殊的区域，称为系统托盘或通知区域，长时间运行的应用程序可以显示图标和短消息。

要检查系统托盘是否存在在用户的桌面上，调用QSystemTrayIcon::isSystemTrayAvailable()静态函数。

要添加系统托盘项，首先，需要创建一个QSystemTrayIcon对象，并调用setContextMenu()为图标提供上下文菜单，然后，调用show()使其在系统托盘中可见。状态通知消息（“气球消息”）可以在任何时候使用showMessage()来进行显示。

当用户激活托盘图标时，activated()信号会被发射。

枚举QSystemTrayIcon::ActivationReason：

此枚举描述了系统托盘被激活的原因。

常量                                               值    描述
QSystemTrayIcon::Unknown    0 未知原因
QSystemTrayIcon::Context 1       系统托盘的上下文菜单请求
QSystemTrayIcon::DoubleClick    2       双击系统托盘
QSystemTrayIcon::Trigger    3             单击系统托盘
QSystemTrayIcon::MiddleClick    4 鼠标中键点击系统托盘

枚举QSystemTrayIcon::MessageIcon：

此枚举描述了显示气球消息时所显示的图标。

常量值    描述
QSystemTrayIcon::NoIcon    0 无图标显示
QSystemTrayIcon::Information 1    一个信息图标显示
QSystemTrayIcon::Warning       2    一个标准的警告图标显示
QSystemTrayIcon::Critical         3    一个严重的警告图标显示

共有函数

QMenu * contextMenu() const ：返回系统托盘的当前上下文菜单。

void setContextMenu(QMenu * menu) ：设置指定菜单为系统托盘的上下文菜单。

当用户通过点击鼠标请求系统托盘的上下文菜单时，菜单会弹出。

注意：系统托盘菜单并不对菜单有所有权，必须确保在恰当的时候删除菜单，例如：创造一个具有合适父对象的菜单。

QRect QSystemTrayIcon::geometry() const ：返回系统托盘图标在屏幕上的几何坐标。

QIcon icon() const

void setIcon(const QIcon & icon)

icon : QIcon ：这个属性保存了系统托盘的图标。

void setToolTip(const QString & tip)

QString toolTip() const

toolTip : QString ：这个属性保存了系统托盘的提示信息。在一些系统中，tooltip的长度是有限的，在必要时tooltip将被截断。

bool isVisible() const
返回系统托盘是否可见。

公有槽函数

void hide()
隐藏系统托盘。

void setVisible(bool visible)
设置系统托盘是否可见。

设置为true或调用show()使系统托盘图标可见；设置为false或调用hide()隐藏它。

void show()
显示系统托盘。

void showMessage(const QString & title, const QString & message, QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::Information, int millisecondsTimeoutHint = 10000)
显示一个气球消息，使用所给出的标题、消息、图标和指定的时间，标题和消息必须是纯文本字符串。

消息可以被用户点击，当用户点击时发出messageClicked()信号。

信号

void activated(QSystemTrayIcon::ActivationReason reason)
当用户激活系统托盘图标，这个信号被发射。reason指定激活的原因， QSystemTrayIcon::ActivationReason列举了各种原因。

void messageClicked()
当使用showMessage()显示的消息被用户点击时，此信号被发射。

静态共有函数

bool isSystemTrayAvailable() [static]
如果系统托盘可用，返回true；否则，返回false。

如果系统盘是当前不可用，但以后变为可用，若QSystemTrayIcon可见，它就会自动在系统托盘中添加条目。

bool supportsMessages() [static]
如果系统托盘支持气球消息，则返回true；否则，返回false。

示例：

首先，自定义系统托盘需要使用的上下文菜单TrayMenu，其继承自QMenu，并通过addAction()为其添加需要的菜单项。

#include <QMenu>

class TrayMenu : public QMenu
{
    Q_OBJECT

public:
    explicit TrayMenu(QWidget *parent = 0);
    ~TrayMenu();

signals:
    // 自定义信号
    void showWindow();

private:
    // 添加菜单项
    void initActions();

private:
    QAction *m_pShowAction;
    QAction *m_pSettingAction;
    QAction *m_pHomePageAction;
    QAction *m_pHelpAction;
    QAction *m_pAboutAction;
    QAction *m_pUpgradeAction;
    QAction *m_pQuitAction;
};

TrayMenu::TrayMenu(QWidget *parent)
    : QMenu(parent)
{
    initActions();
}

TrayMenu::~TrayMenu()
{

}

// 添加菜单项
void TrayMenu::initActions()
{
    // 创建菜单项
    m_pShowAction = new QAction(QIcon(":/icon/open"), QString::fromLocal8Bit("显示"), this);
    m_pSettingAction = new QAction(QIcon(":/icon/setting"), QString::fromLocal8Bit("设置"), this);
    m_pHomePageAction = new QAction(QIcon(":/icon/home"), QString::fromLocal8Bit("登录网页"), this);
    m_pHelpAction= new QAction(QIcon(":/icon/help"), QString::fromLocal8Bit("帮助"), this);
    m_pAboutAction = new QAction(QIcon(":/icon/about"), QString::fromLocal8Bit("关于"), this);
    m_pUpgradeAction = new QAction(QIcon(":/icon/upgrade"), QString::fromLocal8Bit("检查更新"), this);
    m_pQuitAction = new QAction(QIcon(":/icon/quit"), QString::fromLocal8Bit("退出"), this);

    // 添加菜单项
    addAction(m_pShowAction);
    addAction(m_pSettingAction);
    addAction(m_pHomePageAction);
    addSeparator();
    addAction(m_pHelpAction);
    addAction(m_pAboutAction);
    addAction(m_pUpgradeAction);
    addSeparator();
    addAction(m_pQuitAction);

    // 连接信号-信号（仅列举连接显示窗口的信号）
    connect(m_pShowAction, SIGNAL(triggered(bool)), this, SIGNAL(showWindow()));
}

然后，创建系统托盘QSystemTrayIcon，并通过setContextMenu()为其设置自定义的上下文菜单TrayMenu。

MainWindow::MainWindow(QWidget *parent)
    : CustomWindow(parent)
{
    // ...

    QSystemTrayIcon *pSystemTray = new QSystemTrayIcon(this);
    TrayMenu *pTrayMenu = new TrayMenu(this);

    // 设置系统托盘的上下文菜单
    pSystemTray->setContextMenu(pTrayMenu);

    // 设置系统托盘提示信息、托盘图标
    pSystemTray->setToolTip(QString::fromLocal8Bit("我就是托盘"));
    pSystemTray->setIcon(QIcon(":/icon/login"));

    // 连接信号槽
    connect(pTrayMenu, SIGNAL(showWindow()), this, SLOT(showWindow()));
    connect(pSystemTray , SIGNAL(activated(QSystemTrayIcon::ActivationReason)), this, SLOT(onActivated(QSystemTrayIcon::ActivationReason)));

    // 显示系统托盘
    pSystemTray->show();

    // 显示系统托盘提示信息
    pSystemTray->showMessage(QString::fromLocal8Bit("托盘标题"), QString::fromLocal8Bit("托盘显示内容"));
}

// 显示窗体
void MainWindow::showWindow()
{
    showNormal();
    raise();
    activateWindow();
}

// 激活系统托盘
void MainWindow::onActivated(QSystemTrayIcon::ActivationReason reason)
{
    switch(reason)
    {
    // 单击托盘显示窗口
    case QSystemTrayIcon::Trigger:
    {
        showNormal();
        raise();
        activateWindow();
        break;
    }
    // 双击
    case QSystemTrayIcon::DoubleClick:
    {
        // ...
        break;
    }
    default:
        break;
    }
}