为QML创建C++插件(qt qml c++ 开发)
liuian 2025-03-19 14:15 9 浏览
创建插件
由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 - 博客园
相关推荐
- 面试问了解Linux内存管理吗?10张图给你安排的明明白白!
-
来源:https://www.cnblogs.com/NanoDragon/p/12736887.html今天来带大家研究一下Linux内存管理。对于精通CURD的业务同学,内存管理好像离我们很远...
- Linux Kernel 6.12震撼发布:实时性能飙升,开启全新计算时代!
-
概述LinusTorvalds在邮件列表中宣布推出LinuxKernel6.12,该版本带来了多项重要的更新和功能增强。更新亮点PREEMPT_RT支持主要内容:LinuxKernel...
- linux Grub2功能、常见配置及使用方式
-
Grub2(GrandUnifiedBootloaderversion2)是一款功能强大的引导加载程序,提供了以下功能和常见配置:多操作系统支持:Grub2可以加载和引导多个操作系统,包括不同...
- Linux内核必备知识点-platform总线详解
-
platform总线是学习linux驱动必须要掌握的一个知识点。本文参考已发布:Linux3.14内核一、概念嵌入式系统中有很多的物理总线:I2c、SPI、USB、uart、PCIE、APB、AHB...
- linux kernel内核的头文件获取、安装等方法
-
交叉编译时经常会用到这些头文件。下载合适版本的linux地址:https://mirrors.aliyun.com/linux-kernel/https://mirrors.edge.kernel.o...
- 600个常用 Linux 命令,收藏备用!
-
本文为Linux命令大全,从A到Z都有总结,建议大家收藏以便查用,或者查漏补缺!A命令描述access用于检查调用程序是否可以访问指定的文件,用于检查文件是否存在accton用于打开或关闭记帐进程或...
- Linux 中 `/proc/cpuinfo`文件中最常见的标志
-
/proc/cpuinfo是一个虚拟文件系统,在Linux系统中提供有关CPU(中央处理器)的信息。通过读取该文件,您可以获取有关处理器的详细信息,如型号、频率、核心数、缓存大小等。本文将介绍...
- 600个Linux命令大全,从A到Z,2023年收藏大吉!
-
本文为Linux命令大全(有PDF),从A到Z都有总结,建议大家收藏以便查用,或者查漏补缺!A命令描述access用于检查调用程序是否可以访问指定的文件,用于检查文件是否存在accton用于打开或关闭...
- Linux下如何查看硬件信息?
-
我们在Linux下进行开发时,有时也需要知道当前的硬件信息,比如:CPU几核?使用情况?内存大小及使用情况?USB设备是否被识别?等等类似此类问题。下面良许介绍一些常用的硬件查看命令。lshwls...
- 从PXE到GRUB到VHD文件启动
-
今天玩点花活儿,之前的文章再探从VHD文件中启动Windows及Grub双启动VHD文件+TinyCoreLinux中研了一下GRUB和VHD文件的关联应用,那么结合PXE又会是怎么样的呢?...
- bootra1n教学:Windows用户用U盘Linux实现checkra1n越狱方法
-
checkra1n越狱工具在前几天推出Linux版本,相信对于Windows用户可能也看得很模糊,甚至要切割硬碟到安装Linux系统太过于繁杂,这篇要来教大家最简易最快速利用U盘Linux...
- 不了解NUMA,就看不懂Linux内核
-
哈喽,我是子牙,一个很卷的硬核男人深入研究计算机底层、Windows内核、Linux内核、Hotspot源码……聚焦做那些大家想学没地方学的课程。为了保证课程质量及教学效果,一年磨一剑,三年先后做了这...
- Linus Torvalds接受微软Hyper-V升级 下一代Linux启动会更快
-
虽然Windows的粉丝和Linux的粉丝经常喜欢进行激烈的键盘大战,但操作系统的制造商们自己也了解彼此的优缺点。毫无疑问,微软也明白这一点,事实上,它甚至鼓励用户尝试Linux,尽管是使用...
- deepin使用笔记——开机卡LOGO,无法正常关机的解决办法
-
第一次使用deepin操作系统,很容易遇到几种情况:1,开机卡LOGO,无法进入系统。2,开机可以进入系统,但是进入系统后桌面环境无法正常打开,一直卡着什么都不能用。3,开机后看似一切正常,但关机的时...
- 如何检查Linux系统硬件信息?从CPU到显卡,一网打尽!
-
你可能会问:“我为什么要关心硬件信息?”答案很简单:硬件是Linux系统的根基,了解它可以帮你解决很多实际问题。比如:性能调优:知道CPU核心数和内存大小,才能更好地调整程序运行参数。故障排查:系统卡...
- 一周热门
-
-
Python实现人事自动打卡,再也不会被批评
-
Psutil + Flask + Pyecharts + Bootstrap 开发动态可视化系统监控
-
一个解决支持HTML/CSS/JS网页转PDF(高质量)的终极解决方案
-
【验证码逆向专栏】vaptcha 手势验证码逆向分析
-
再见Swagger UI 国人开源了一款超好用的 API 文档生成框架,真香
-
网页转成pdf文件的经验分享 网页转成pdf文件的经验分享怎么弄
-
C++ std::vector 简介
-
python使用fitz模块提取pdf中的图片
-
《人人译客》如何规划你的移动电商网站(2)
-
Jupyterhub安装教程 jupyter怎么安装包
-
- 最近发表
- 标签列表
-
- 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)
- table.render (33)
- uniapp textarea (33)
- python判断元素在不在列表里 (34)
- python 字典删除元素 (34)
- react-admin (33)
- vscode切换git分支 (35)
- vscode美化代码 (33)
- python bytes转16进制 (35)