为QML创建C++插件(qt qml c++ 开发)
liuian 2025-03-19 14:15 17 浏览
创建插件
由QML 引擎来为QML加载C++ 插件。这种插件通常是以QML扩展模块的形式出现的,它们被QML文档导入,并为QML文档中的客户端提供类型。模块需要至少一个有效的注册类型。
QQmlEngineExtensionPlugin 是一个插件接口,它允许创建,能被动态加载到QML应用中的QML扩展。这些扩展允许自定义被QML引擎识别的QML类型。
要写这样的扩展插件,如下操作:
1、继承QQmlEngineExtensionPlugin 并使用 Q_PLUGIN_METADATA() 宏,用Qt的元对象机制来注册一个插件。
2、使用QML_ELEMENT 和 QML_NAMED_ELEMENT() 宏来声明QML类型。
3、配置构建文件
CMake:
qt_add_qml_module(
URI
VERSION 1.0
QML_FILES
NO_RESOURCE_TARGET_PATH
)
qmake:
CONFIG += qmltypes
QML_IMPORT_NAME =
QML_IMPORT_MAJOR_VERSION =
4、如果是使用qmake,要创建一个qmldir文件来描述这个插件。注意CMake将会自动生成这个qmldir文件。
QML扩展插件有应用程序规格、类库文件两种。库文件插件应当限定自身来注册类型,因为对引擎根上下文的任意操作可能会引起冲突,或用户库文件代码的其它问题。
链接器可能错误地删除注册类型,而将其当作一种优化。可以通过声明一个指向代码中的某个易失性指针,来阻止以上误删除。如果你的类型名为"my.module",就应该在全局添加一个声明:
void qml_register_types_my_module();
然后在在同库的实现文件的任意函数中添加如下代码段,实现注册:
volatile auto registration = &qml_register_types_my_module;
Q_UNUSED(registration);
TimeExample QML 扩展插件
假定有一个新的 TimeModel C++ 类,要成为新的有效QML类型。它能过hour和minute两个属性来提供当前时间。它通过宏QML_NAMED_ELEMENT() 声明了一个名为Time 的QML类型。
class TimeModel : public QObject
{
Q_OBJECT
Q_PROPERTY(int hour READ hour NOTIFY timeChanged)
Q_PROPERTY(int minute READ minute NOTIFY timeChanged)
QML_NAMED_ELEMENT(Time)
...
要使这个类型有效,需要创建一人名为QExampleQmlPlugin,继承自QQmlEngineExtensionPlugin的类。它在类定义中通过向宏Q_PLUGIN_METADATA()传入一个唯一标识符向Qt的元对象系统注册插件。
class QExampleQmlPlugin : public QQmlEngineExtensionPlugin
{
Q_OBJECT
Q_PLUGIN_METADATA(IID QQmlEngineExtensionInterface_iid)
};
为插件构建设置
构建文件定义工程为插件库,指定其将被生成到imports/TimeExample路径,并为插件注册了目标名称。
使用CMake:
set(qml_files
imports/TimeExample/Clock.qml
)
set(images
imports/TimeExample/center.png
imports/TimeExample/clock.png
imports/TimeExample/hour.png
imports/TimeExample/minute.png
)
qt_add_qml_module(qmlqtimeexample
OUTPUT_DIRECTORY imports/TimeExample
VERSION 1.0
URI "TimeExample"
SOURCES timemodel.cpp timemodel.h
QML_FILES ${qml_files}
RESOURCES ${images}
)
使用qmake:
TEMPLATE = lib
CONFIG += qt plugin qmltypes
QT += qml
QML_IMPORT_NAME = TimeExample
QML_IMPORT_MAJOR_VERSION = 1
DESTDIR = imports/$QML_IMPORT_NAME
TARGET = qmlqtimeexampleplugin
SOURCES += qexampleqmlplugin.cpp
这样就为TimeModel类,注册了导入名为TimeModel 1.0,且QML类型名为Time。文章从C++ 来定义QML类型 里有更多信息关于如何注册能在QML中使用的C++ 类型。
在qmldir中的插件定义
最后,需要在imports/TimeExample路径下创建一个qmldir 文件,来描述插件及其导出的类型。插件包含一个Clock.qml文件,和qmlqtimeexampleplugin一起被工程构建。
CMake将自动生成qmldir文件。想了解更多信息,查看自动生成qmldir和类型信息文件
当使用qmake时,要在qmldir文件中写入如下代码:
module TimeExample
Clock 1.0 Clock.qml
plugin qmlqtimeexampleplugin
本例中,为简化起见,TimeExaple源文件路径设为 imports/TimeExample,在源码中构建。然而,源码路径并不重要,因为qmldir文件可以指定路径来安装QML文件。
重要的是qmldir文件所在的文件路径。当用户导入模块,QML引擎使用模块标识符(TimeExample)来查找插件,所以其(qmldir)安装路径必须与模块标识符匹配。
一旦项目被构建和安装,任意导入TimeExample模块的QML都可以访问Time 组件
import TimeExample 1.0 // import types from the plugin
Clock { // this class is defined in QML (imports/TimeExample/Clock.qml)
Time { // this class is defined in C++ (plugin.cpp)
id: time
}
hours: time.hour
minutes: time.minute
}
文章转自博客园(sammy621):为QML创建C++插件 - sammy621 - 博客园
相关推荐
- eino v0.4.5版本深度解析:接口类型处理优化与错误机制全面升级
-
近日,eino框架发布了v0.4.5版本,该版本在错误处理、类型安全、流处理机制以及代理配置注释等方面进行了多项优化与修复。本次更新共包含6个提交,涉及10个文件的修改,由2位贡献者共同完成。本文将详...
- SpringBoot异常处理_springboot异常注解
-
在SpringBoot中,异常处理是构建健壮、可维护Web应用的关键部分。良好的异常处理机制可以统一返回格式、提升用户体验、便于调试和监控。以下是SpringBoot中处理异常的完整指...
- Jenkins运维之路(Jenkins流水线改造Day02-1-容器项目)
-
这回对线上容器服务器的流水线进行了一定的改造来满足目前线上的需求,还是会将所有的自动化脚本都放置到代码库中统一管理,我感觉一章不一定写的完,所以先给标题加了个-1,话不多说开干1.本次流水线的流程设计...
- 告别宕机!零基础搭建服务器监控告警系统!小白也能学会!
-
前言本文将带你从零开始,一步步搭建一个完整的服务器指标监控与邮件告警系统,使用的技术栈均为业界主流、稳定可靠的开源工具:Prometheus:云原生时代的监控王者,擅长指标采集与告警规则定义Node_...
- httprunner实战接口测试笔记,拿走不谢
-
每天进步一点点,关注我们哦,每天分享测试技术文章本文章出自【码同学软件测试】码同学公众号:自动化软件测试码同学抖音号:小码哥聊软件测试01开始安装跟创建项目pipinstallhttprunne...
- 基于JMeter的性能压测平台实现_jmeter压测方案
-
这篇文章已经是两年前写的,短短两年时间,JMeter开源应用技术的发展已经是翻天覆地,最初由github开源项目zyanycall/stressTestPlatform形成的这款测试工具也开始慢...
- 12K+ Star!新一代的开源持续测试工具!
-
大家好,我是Java陈序员。在企业软件研发的持续交付流程中,测试环节往往是影响效率的关键瓶颈,用例管理混乱、接口调试复杂、团队协作不畅、与DevOps流程脱节等问题都能影响软件交付。今天,给大家...
- Spring Boot3 中分库分表之后如何合并查询
-
在当今互联网应用飞速发展的时代,数据量呈爆发式增长。对于互联网软件开发人员而言,如何高效管理和查询海量数据成为了一项关键挑战。分库分表技术应运而生,它能有效缓解单库单表数据量过大带来的性能瓶颈。而在...
- 离线在docker镜像方式部署ragflow0.17.2
-
经常项目上会出现不能连外网的情况,要怎么使用ragflow镜像部署呢,这里提供详细的步骤。1、下载基础镜像根据docker-compose-base.yml及docker-compose.yml中的i...
- 看,教你手写一个最简单的SpringBoot Starter
-
何为Starter?想必大家都使用过SpringBoot,在SpringBoot项目中,使用最多的无非就是各种各样的Starter了。那何为Starter呢?你可以理解为一个可拔插式...
- 《群星stellaris》军事基地跳出怎么办?解决方法一览
-
《群星stellaris》军事基地跳出情况有些小伙伴出现过这种情况,究竟该怎么解决呢?玩家“gmjdadk”分享的自己的解决方法,看看能不能解决。我用英文原版、德语、法语和俄语四个版本对比了一下,结果...
- 数据开发工具dbt手拉手教程-03.定义数据源模型
-
本章节介绍在dbt项目中,如何定义数据源模型。定义并引入数据源通过Extract和Load方式加载到仓库中的数据,可以使用dbt中的sources组件进行定义和描述。通过在dbt中将这些数据集(表)声...
- docker compose 常用命令手册_docker-compose init
-
以下是DockerCompose常用命令手册,按生命周期管理、服务运维、构建配置、扩缩容、调试工具分类,附带参数解析、示例和关键说明,覆盖多容器编排核心场景:一、生命周期管理(核心命令...
- RagFlow与DeepSeek R1本地知识库搭建详细步骤及代码实现
-
一、环境准备硬件要求独立显卡(建议NVIDIAGPU,8GB显存以上)内存16GB以上,推荐32GB(处理大规模文档时更高效)SSD硬盘(加速文档解析与检索)软件安装bash#必装组件Docker...
- Docker Compose 配置更新指南_docker-compose配置
-
高效管理容器配置变更的最佳实践方法重启范围保留数据卷适用场景docker-composeup-d变更的服务常规配置更新--force-recreate指定/所有服务强制重建down→up流程...
- 一周热门
-
-
【验证码逆向专栏】vaptcha 手势验证码逆向分析
-
Python实现人事自动打卡,再也不会被批评
-
Psutil + Flask + Pyecharts + Bootstrap 开发动态可视化系统监控
-
一个解决支持HTML/CSS/JS网页转PDF(高质量)的终极解决方案
-
再见Swagger UI 国人开源了一款超好用的 API 文档生成框架,真香
-
网页转成pdf文件的经验分享 网页转成pdf文件的经验分享怎么弄
-
C++ std::vector 简介
-
飞牛OS入门安装遇到问题,如何解决?
-
系统C盘清理:微信PC端文件清理,扩大C盘可用空间步骤
-
10款高性能NAS丨双十一必看,轻松搞定虚拟机、Docker、软路由
-
- 最近发表
- 标签列表
-
- python判断字典是否为空 (50)
- crontab每周一执行 (48)
- aes和des区别 (43)
- bash脚本和shell脚本的区别 (35)
- canvas库 (33)
- dataframe筛选满足条件的行 (35)
- gitlab日志 (33)
- lua xpcall (36)
- blob转json (33)
- python判断是否在列表中 (34)
- python html转pdf (36)
- 安装指定版本npm (37)
- idea搜索jar包内容 (33)
- css鼠标悬停出现隐藏的文字 (34)
- linux nacos启动命令 (33)
- gitlab 日志 (36)
- adb pull (37)
- python判断元素在不在列表里 (34)
- python 字典删除元素 (34)
- vscode切换git分支 (35)
- python bytes转16进制 (35)
- grep前后几行 (34)
- hashmap转list (35)
- c++ 字符串查找 (35)
- mysql刷新权限 (34)