百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT知识 > 正文

为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 - 博客园

Qt开发必备技术栈学习路线和资料

相关推荐

面试问了解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核心数和内存大小,才能更好地调整程序运行参数。故障排查:系统卡...