在QML中使用QSystemTrayIcon(系统托盘)

2024-06-03 21:08

本文主要是介绍在QML中使用QSystemTrayIcon(系统托盘),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

【写在前面】

        写这篇文章的时候应该不算晚,因为 qml 中并没有正式的系统托盘组件。

        但是,在 Qt Labs Platform 模块中( 实验模块,Qt 5.8引入 ),已经有了 SystemTrayIcon,相信以后会作为正式的模块进入 qml。

        即便如此,本文仍提供了一种在qml中使用 QSystemTrayIcon 的方法,或者也可以作为 qml 与 c++ 交互的例子来看。


【正文开始】

        先上完成后的 qml 代码:

        main.qml

import QtQuick 2.7
import QtQuick.Window 2.2
import an.utility 1.0Window
{id: rootvisible: truewidth: 400height: 200title: qsTr("Hello World")Rectangle{anchors.fill: parentcolor: "red"}SystemTray{id: systemTraymenu: menuvisible: trueicon: "qrc:/winIcon.png"toolTip: "托盘运行中..."onTrigger:{root.requestActivate();root.show();}MyMenu{id: menuMyAction{text: "我在线上"icon: "qrc:/winIcon.png"}MyAction{text: "Q我吧"icon: "qrc:/winIcon.png"}MySeparator {}MyAction{text: "离开"icon: "qrc:/winIcon.png"}MyAction{text: "忙碌"icon: "qrc:/winIcon.png"}}}
}

        效果图:

        可以看到,效果和 widget 下使用是一样的,但用 qml 更简单更方便。

        自定义的 SystemTrayIcon 我注册到 an.utility 1.0 中。下面讲解其实现。

        systemtrayicon.h

#ifndef SYSTEMTRAYICON_H
#define SYSTEMTRAYICON_H#include <QAction>
#include <QQuickItem>
#include <QSystemTrayIcon>class MyAction : public QAction
{Q_OBJECTQ_PROPERTY(QUrl icon READ icon WRITE setIcon NOTIFY iconChanged)    //Q_PROPERTY宏提供在qml中访问的信号槽等等public:MyAction(QObject *parent = nullptr);~MyAction();QUrl icon() const;signals:void iconChanged();public slots:void setIcon(const QUrl &arg);private:QUrl m_icon;
};class MySeparator : public QObject
{
public:MySeparator(QObject *parent = nullptr);~MySeparator();
};class SystemTray;
class MyMenu : public QQuickItem
{Q_OBJECTQ_PROPERTY(int width READ width WRITE setWidth NOTIFY widthChanged)Q_PROPERTY(int height READ height WRITE setHeight NOTIFY heightChanged)public:MyMenu(QQuickItem *parent = nullptr);~MyMenu();int width() const;int height() const;void clear();signals:void widthChanged();void heightChanged();public slots:void setWidth(int arg);void setHeight(int arg);void addSeparator();void addAction(MyAction *action);void addMenu(MyMenu *menu);protected:void componentComplete();private:friend class SystemTrayIcon;    //让SystemTray能够直接访问m_menuQMenu *m_menu;
};class SystemTrayIcon : public QQuickItem
{Q_OBJECTQ_PROPERTY(int x READ x CONSTANT)Q_PROPERTY(int y READ y CONSTANT)Q_PROPERTY(QUrl icon READ icon WRITE setIcon NOTIFY iconChanged)Q_PROPERTY(QString toolTip READ toolTip WRITE setToolTip NOTIFY toolTipChanged)Q_PROPERTY(MyMenu* menu READ menu WRITE setMenu NOTIFY menuChanged)public:SystemTrayIcon(QQuickItem *parent = nullptr);~SystemTrayIcon();int x() const;int y() const;QUrl icon() const;QString toolTip() const;MyMenu* menu() const;signals:void trigger();void iconChanged();void toolTipChanged();void menuChanged();public slots:void setIcon(const QUrl &arg);void setToolTip(const QString &arg);void setMenu(MyMenu *arg);void onVisibleChanged();void onActivated(QSystemTrayIcon::ActivationReason reason);void onExit();private:QSystemTrayIcon *m_systemTray;MyMenu *m_menu;QString m_toolTip;QUrl m_icon;
};#endif // SYSTEMTRAYICON_H

        要将 c++ 类导入到 qml 必须继承自 QObject 或其派生类,并使用 Q_OBJECT 宏。

        而继承 QQuickItem 是为了得到 item 中的其他一些属性和信号,以及重实现 void componentComplete()。

        该函数在组件完成时调用,重新实现来添加必要的操作。

        systemTrayIcon.cpp

#include <QApplication>
#include <QMenu>
#include <QAction>
#include "systemtrayicon.h"MyAction::MyAction(QObject *parent):   QAction(parent)
{setObjectName("MyAction");
}MyAction::~MyAction()
{}QUrl MyAction::icon() const
{return m_icon;
}void MyAction::setIcon(const QUrl &arg)
{if(m_icon != arg){QString str = arg.toLocalFile();if(str == "") str = arg.toString();     //如果转换失败if( str.mid (0, 3) == "qrc")str = str.mid (3, str.count() - 3);QAction::setIcon(QIcon(str));m_icon = arg;emit iconChanged();}
}MySeparator::MySeparator(QObject *parent):   QObject(parent)
{setObjectName("MySeparator");
}MySeparator::~MySeparator()
{}MyMenu::MyMenu(QQuickItem *parent):   QQuickItem(parent)
{setObjectName("MyMenu");m_menu = new QMenu();
}MyMenu::~MyMenu()
{}int MyMenu::width() const
{return m_menu->width();
}int MyMenu::height() const
{return m_menu->height();
}void MyMenu::clear()    //清空caidan
{m_menu->clear();
}void MyMenu::setWidth(int arg)
{if (m_menu->width() != arg){m_menu->setFixedWidth(arg);emit widthChanged();}
}void MyMenu::setHeight(int arg)
{if (m_menu->height() != arg){m_menu->setFixedHeight(arg);emit heightChanged();}
}void MyMenu::addAction(MyAction *action)
{m_menu->addAction(action);
}void MyMenu::addSeparator()
{m_menu->addSeparator();
}void MyMenu::addMenu(MyMenu *menu)
{m_menu->addMenu(menu->m_menu);
}void MyMenu::componentComplete()        //在菜单完成构建后调用,将自定义Action,Menu,Separator通过objectName判断加入
{QQuickItem::componentComplete();QObjectList list = children();for (auto it : list){if (it->objectName() == "MyAction"){MyAction *action = qobject_cast<MyAction *>(it);m_menu->addAction(action);}else if (it->objectName() == "MySeparator"){m_menu->addSeparator();}else if (it->objectName() == "MyMenu"){MyMenu *menu = qobject_cast<MyMenu *>(it);m_menu->addMenu(menu->m_menu);}}
}SystemTrayIcon::SystemTrayIcon(QQuickItem *parent):   QQuickItem(parent)
{m_systemTray = new QSystemTrayIcon(this);connect(m_systemTray, &QSystemTrayIcon::activated, this, &SystemTrayIcon::onActivated);connect(this, &SystemTrayIcon::visibleChanged, this, &SystemTrayIcon::onVisibleChanged);setVisible(false);              //给visible一个初始值,否则会不显示
}SystemTrayIcon::~SystemTrayIcon()
{}int SystemTrayIcon::x() const
{return m_systemTray->geometry().x();
}int SystemTrayIcon::y() const
{return m_systemTray->geometry().y();
}QUrl SystemTrayIcon::icon() const
{return m_icon;
}QString SystemTrayIcon::toolTip() const
{return m_systemTray->toolTip();
}MyMenu *SystemTrayIcon::menu() const
{return m_menu;
}void SystemTrayIcon::setIcon(const QUrl &arg)
{if(m_icon != arg){QString str = arg.toLocalFile();if(str == "") str = arg.toString(); //如果转换失败if( str.mid (0, 3) == "qrc")str = str.mid (3, str.count() - 3);m_systemTray->setIcon(QIcon(str));m_icon = arg;emit iconChanged();}
}void SystemTrayIcon::setToolTip(const QString &arg)
{if (m_toolTip != arg){m_systemTray->setToolTip(arg);m_toolTip = arg;emit toolTipChanged();}
}void SystemTrayIcon::setMenu(MyMenu *arg)    //设置托盘上下文菜单
{if (m_menu != arg){m_menu = arg;m_systemTray->setContextMenu(m_menu->m_menu);m_systemTray->installEventFilter(this);emit menuChanged();}
}void SystemTrayIcon::onVisibleChanged()    //visible可见性改变时显示/隐藏托盘
{m_systemTray->setVisible(isVisible());
}void SystemTrayIcon::onActivated(QSystemTrayIcon::ActivationReason reason)
{switch (reason){case QSystemTrayIcon::DoubleClick:case QSystemTrayIcon::Trigger:emit trigger();            //单击双击托盘图标时发送trigger()信号, reason类似还有Context,MiddleClick,Unknowdefault:break;}
}void SystemTrayIcon::onExit()    //应在程序退出时调用,防止图标不消失
{m_systemTray->hide();QApplication::exit(0);
}

        main.cpp

#include <QApplication>
#include <QQmlApplicationEngine>
#include "systemtrayicon.h"int main(int argc, char *argv[])
{QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);QApplication app(argc, argv);QQmlApplicationEngine engine;qmlRegisterType<MyMenu>("an.utility", 1, 0, "MyMenu");        //注册到qml中qmlRegisterType<MyAction>("an.utility", 1, 0, "MyAction");qmlRegisterType<MySeparator>("an.utility", 1, 0, "MySeparator");qmlRegisterType<SystemTrayIcon>("an.utility", 1, 0, "SystemTrayIcon");engine.load(QUrl(QLatin1String("qrc:/main.qml")));if (engine.rootObjects().isEmpty())return -1;return app.exec();
}

【结语】

        好吧,还有很多地方没有完善,比如快捷键。

        其实写自定义组件和写 widget 差不多。。不过写好之后,在qml中使用起来就非常方便了。

        当然,最后我自己试了试 Qt.labs.platform 1.0 中的 SystemTrayIcon,嗯基本上差不多吧。。所以期待以后的版本正式加入咯。

这篇关于在QML中使用QSystemTrayIcon(系统托盘)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1028117

相关文章

使用Sentinel自定义返回和实现区分来源方式

《使用Sentinel自定义返回和实现区分来源方式》:本文主要介绍使用Sentinel自定义返回和实现区分来源方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Sentinel自定义返回和实现区分来源1. 自定义错误返回2. 实现区分来源总结Sentinel自定

Pandas使用SQLite3实战

《Pandas使用SQLite3实战》本文主要介绍了Pandas使用SQLite3实战,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学... 目录1 环境准备2 从 SQLite3VlfrWQzgt 读取数据到 DataFrame基础用法:读

JSON Web Token在登陆中的使用过程

《JSONWebToken在登陆中的使用过程》:本文主要介绍JSONWebToken在登陆中的使用过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录JWT 介绍微服务架构中的 JWT 使用结合微服务网关的 JWT 验证1. 用户登录,生成 JWT2. 自定义过滤

Java中StopWatch的使用示例详解

《Java中StopWatch的使用示例详解》stopWatch是org.springframework.util包下的一个工具类,使用它可直观的输出代码执行耗时,以及执行时间百分比,这篇文章主要介绍... 目录stopWatch 是org.springframework.util 包下的一个工具类,使用它

Java使用Curator进行ZooKeeper操作的详细教程

《Java使用Curator进行ZooKeeper操作的详细教程》ApacheCurator是一个基于ZooKeeper的Java客户端库,它极大地简化了使用ZooKeeper的开发工作,在分布式系统... 目录1、简述2、核心功能2.1 CuratorFramework2.2 Recipes3、示例实践3

springboot security使用jwt认证方式

《springbootsecurity使用jwt认证方式》:本文主要介绍springbootsecurity使用jwt认证方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录前言代码示例依赖定义mapper定义用户信息的实体beansecurity相关的类提供登录接口测试提供一

go中空接口的具体使用

《go中空接口的具体使用》空接口是一种特殊的接口类型,它不包含任何方法,本文主要介绍了go中空接口的具体使用,具有一定的参考价值,感兴趣的可以了解一下... 目录接口-空接口1. 什么是空接口?2. 如何使用空接口?第一,第二,第三,3. 空接口几个要注意的坑坑1:坑2:坑3:接口-空接口1. 什么是空接

springboot security快速使用示例详解

《springbootsecurity快速使用示例详解》:本文主要介绍springbootsecurity快速使用示例,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝... 目录创www.chinasem.cn建spring boot项目生成脚手架配置依赖接口示例代码项目结构启用s

Python如何使用__slots__实现节省内存和性能优化

《Python如何使用__slots__实现节省内存和性能优化》你有想过,一个小小的__slots__能让你的Python类内存消耗直接减半吗,没错,今天咱们要聊的就是这个让人眼前一亮的技巧,感兴趣的... 目录背景:内存吃得满满的类__slots__:你的内存管理小助手举个大概的例子:看看效果如何?1.

java中使用POI生成Excel并导出过程

《java中使用POI生成Excel并导出过程》:本文主要介绍java中使用POI生成Excel并导出过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录需求说明及实现方式需求完成通用代码版本1版本2结果展示type参数为atype参数为b总结注:本文章中代码均为