qmlRegisterType 的功能以及用法

最新推荐文章于 2025-02-18 00:23:19 发布

转载最新推荐文章于 2025-02-18 00:23:19 发布 · 9k 阅读

文章标签：

#qmlRegisterType #QML #C++

QML 专栏收录该内容

7 篇文章

订阅专栏

本文详细介绍了qmlRegisterType函数的使用方法及其在QML与C++交互中的作用。qmlRegisterType用于将C++类注册到QML环境中，使C++类能在QML中被调用。文章通过实例展示了如何正确配置该函数的参数，并提到了类名大小写的重要性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

qmlRegisterType 是一个可以将C++实现的类在QML中调用的，连接C++和QML的一个工具，非常重要的函数！！！

首先来看QtHelp关于qmlRegisterType 的介绍

int qmlRegisterType(const char * uri, int versionMajor, int versionMinor, const char * qmlName)
This template function registers the C++ type in the QML system with the name qmlName, in the library imported from uri having the version number composed from versionMajor and versionMinor.
Returns the QML type id.

可以看到qmlRegisterType里总共4个参数：第一个参数* uri指的是QML中import后的内容，相当于头文件名；第二个第三个参数分别是主次版本号；第四个指的是QML中类的名字。
下面举个例子
在main.cpp文件中

#include <QtQml>
qmlRegisterType<MySliderItem>("com.mycompany.qmlcomponents", 1, 0, "Slider");

在main.qml文件中：

import com.mycompany.qmlcomponents 1.0
Slider {
}

注意：第四个QML的类名首字母一定要大写，要不然会报错。。而且是那种你找不到的。。
有两种使用方法：

 int qmlRegisterType(const char *uri, int versionMajor, int versionMinor, const char *qmlName)

 int qmlRegisterType(const QUrl &url, const char *uri, int versionMajor, int versionMinor, const char *qmlName)

后面一种只是多了一个链接参数，可以连接非本地的各类库函数

  QUrl url("http://www.example.com/List of holidays.xml");
  // url.toEncoded() == "http://www.example.com/List%20of%20holidays.xml"

来源：https://blog.youkuaiyun.com/Xiaoshiniudao889/article/details/62049798