QML: C++调用QML函数

最新推荐文章于 2025-08-25 10:16:43 发布
原创 最新推荐文章于 2025-08-25 10:16:43 发布 · 612 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#qt #开发语言 #c++

本文介绍了如何在C++中调用QML的函数，重点讲述了通过Q_RETURN_ARG和Q_ARG宏来处理返回值和参数。文章提供了一个实例，详细说明了如何通过设置objectName并在C++中使用findChild()找到并调用QML对象的方法。

C++调用qml函数，是通过下面的函数实现的：

bool QMetaObject::invokeMethod(QObject *obj, const char *member, Qt::ConnectionType type, QGenericReturnArgument ret, <br>QGenericArgument val0 = QGenericArgument( Q_NULLPTR ), QGenericArgument val1 = QGenericArgument(), QGenericArgument val2 = QGenericArgument(),<br> QGenericArgument val3 = QGenericArgument(), QGenericArgument val4 = QGenericArgument(), QGenericArgument val5 = QGenericArgument(), QGenericArgument val6 = QGenericArgument(),<br> QGenericArgument val7 = QGenericArgument(), QGenericArgument val8 = QGenericArgument(), QGenericArgument val9 = QGenericArgument())；

这里有两个常用的宏：Q_RETURN_ARG,Q_ARG，从字面意思就可以看出来，一个是用来获取返回值，另一个用于传参。 下面是一个例子：

QVariant returnedValue;
QVariant msg = "message sended from C++";
QMetaObject::invokeMethod(pctrlobj, "setTextString", Q_RETURN_ARG(QVariant, returnedValue),Q_ARG(QVariant, msg));

在应用该函数调用qml对象成员前，关键是要获取到要调用的qml对象，有两种方案可以很方便的获取到qml对象：</

最低0.47元/天 解锁文章
Qt开发老杰
关注
QML与C++相互调用函数并获得返回值
cpp_learner的博客
07-12 1070
本文详细介绍了QML与C++之间的双向函数调用方法，重点演示了复杂类型（如QJsonObject/QMap和QList/QJsonArray）的处理方式。在C++端，通过Q_INVOKABLE修饰函数并注册为单例对象，使QML可以直接调用；在QML端定义函数后，C++通过QMetaObject::invokeMethod进行调用。文章还特别讲解了返回值处理技巧：对于QJSValue类型可转换为QJsonObject/QMap或QVariantList/QJsonArray，若返回JSON字符串则可直接解析。
C++调用QML代码
m0_73443478的博客
05-26 622
C++调用QML代码
QT与QML插件调用技术详解
最新发布
weixin_42097508的博客
08-25 408
QT是一个跨平台的C++应用程序框架，广泛应用于开发图形用户界面程序以及跨平台的应用程序。它的跨平台特性支持Linux、Windows、MacOS等多个操作系统，使得开发者只需编写一次代码，即可编译运行于多个平台。QML（Qt Modeling Language）是一种基于JSON的声明式脚本语言，它允许开发者快速开发动态和流畅的用户界面。通过QML，开发者可以很方便地定义对象的外观和行为，而其背后的逻辑可以通过C++进行实现，提供了灵活的模块化和可重用性。
在C++程序中使用QML
12-21
在C++程序中使用QML QML API是分为三个主类——QDeclarativeEngine， QdeclarativeComponent 与 QDeclarativeContext。QDeclarativeEngine 提供QML运行的环境，QdeclarativeComponent 封装了QML Documents 与QDeclarativeContext允许程序导出数据到QML组件实例。 QML还包含了API的一个方便，通过QDeclarativeView 应用程序只需要简单嵌入QML组件到一个新的QGraphicsView就可以了。这有许多细节将在下面讨论。QDeclarativeView 主要是用于快速成型的应用程序里。 如果你是重新改进使用QML的Qt应用程序，请参阅 整合QML到现有的Qt UI代码。 基本用法 每个应用程序至少需求一个QDeclarativeEngine。QDeclarativeEngine允许配置全局设置应用到所有的QML组件实例中，例如QNetworkAccessManager是用于网络通信以及永久储存的路径。如果应用程序需求在QML组件实例间需求不同的设置只需要多个QDeclarativeEngine。 使用QDeclarativeComponent类载入QML Documents。每个QDeclarativeComponent实例呈现单一QML文档。QDeclarativeComponent可以传递一个文档的地址或文档的原始文本内容。该文档的URL可以是本地文件系统的地址或通过QNetworkAccessManager支持的网络地址。 QML组件实例通过调用QDeclarativeComponent::create()模式来创建。在这里载入一个QML文档的示例并且从它这里创建一个对象。 QDeclarativeEngine *engine = new QDeclarativeEngine(parent); QDeclarativeComponent component(engine, QUrl::fromLocalFile(“main.qml”)); QObject *myObject = component.create(); 导出数据 QML组件是以QDeclarativeContext实例化的。context允许应用程序导出数据到该QML组件实例中。单个QDeclarativeContext 可用于一应用程序的所有实例对象或针对每个实例使用QDeclarativeContext 可以创建更为精确的控制导出数据。如果不传递一个context给QDeclarativeComponent::create()模式；那么将使用QDeclarativeEngine的root context。数据导出通过该root context对所有对象实例是有效的。 简单数据 为了导出数据到一个QML组件实例，应用程序设置Context属性；然后由QML属性绑定的名称与JavaScrip访问。下面的例子显示通过QGraphicsView如何导出一个背景颜色到QML文件中： //main.cpp #include <QApplication> #include <QDeclarativeView> #include <QDeclarativeContext> int main(int argc, char *argv[]) { QApplication app(argc, argv); QDeclarativeView view; QDeclarativeContext *context = view.rootContext(); context->setContextProperty(“backgroundColor”, QColor(Qt::yellow)); view.setSource(QUrl::fromLocalFile(“main.qml”)); view.show(); return app.exec(); } //main.qml import Qt 4.7 Rectangle { width: 300 height: 300 color: backgroundColor Text { anchors.centerIn: parent text: “Hello Yellow World!” } } 或者，如果你需要main.cpp不需要在QDeclarativeView显示创建的组件，你就需要使用QDeclarativeEngine::rootContext()替代创建QDeclarativeContext实例。 QDeclarativeEngine engine; QDeclarativeContext *windowContext = new QDeclarativeContext(engine.rootContext()); windowContext->setContextProperty(“backgroundColor”, QColor(Qt::yellow)); QDeclarativeComponent component(&engine, “main.qml”); QObject *window = component.create(windowContext); Context属性的操作像QML绑定的标准属性那样——在这个例子中的backgroundColor Context属性改变为红色；那么该组件对象实例将自动更新。注意：删除任意QDeclarativeContext的构造是创建者的事情。当window组件实例撤消时不再需要windowContext时，windowContext必须被消毁。最简单的方法是确保它设置window作为windowContext的父级。 QDeclarativeContexts 是树形结构——除了root context每个QDeclarativeContexts都有一个父级。子级QDeclarativeContexts有效的继承它们父级的context属性。这使应用程序分隔不同数据导出到不同的QML对象实例有更多自由性。如果QDeclarativeContext设置一context属性，同样它父级也被影响，新的context属性是父级的影子。如下例子中，background context属性是Context 1，也是root context里background context属性的影子。 结构化数据 context属性同样可用于输出结构化与写数据到QML对象。除了QVariant支持所有已经存在的类型外，QObject 派生类型可以分配给context属性。 QObject context属性允许数据结构化输出并允许QML来设置值。 下例创建CustomPalette对象并设置它作为palette context属性。 class CustomPalette : public QObject { Q_OBJECT Q_PROPERTY(QColor background READ background WRITE setBackground NOTIFY backgroundChanged) Q_PROPERTY(QColor text READ text WRITE setText NOTIFY textChanged) public: CustomPalette() : m_background(Qt::white), m_text(Qt::black) {} QColor background() const { return m_background; } void setBackground(const QColor &c) { if (c != m_background) { m_background = c; emit backgroundChanged(); } } QColor text() const { return m_text; } void setText(const QColor &c) { if (c != m_text) { m_text = c; emit textChanged(); } } signals: void textChanged(); void backgroundChanged(); private: QColor m_background; QColor m_text; }; int main(int argc, char *argv[]) { QApplication app(argc, argv); QDeclarativeView view; view.rootContext()->setContextProperty(“palette”, new CustomPalette); view.setSource(QUrl::fromLocalFile(“main.qml”)); view.show(); return app.exec(); } QML引用palette对象以及它的属性，为了设置背景与文本的颜色，这里是当单击窗口时，面板的文本颜色将改变成蓝色。 import Qt 4.7 Rectangle { width: 240 height: 320 color: palette.background Text { anchors.centerIn: parent color: palette.text text: “Click me to change color!” } MouseArea { anchors.fill: parent onClicked: { palette.text = “blue”; } } } 可以检测一个C++属性值——这种情况下的CustomPalette的文本属性改变，该属性必须有相应的NOTIFY信息。NOTIFY信号是属性值改变时将指定一个信号发射。 实现者应该注意的是，只有值改变时才发射信号，以防止发生死循环。访问一个绑定的属性，没有NOTIFY信号的话，将导致QML在运行时发出警告信息。 动态结构化数据 如果应用程序对结构化过于动态编译QObject类型；那么对动态结构化数据可在运行时使用QDeclarativePropertyMap 类构造。 从QML调用 C++ 通过public slots输出模式或Q_INVOKABLE标记模式使它可以调用QObject派生出的类型。 C++模式同样可以有参数并且可以返回值。QML支持如下类型： •bool •unsigned int, int •float, double, qreal •QString •QUrl •QColor •QDate,QTime,QDateTime •QPoint,QPointF •QSize,QSizeF •QRect,QRectF •QVariant 下面例子演示了，当MouseArea单击时控制“Stopwatch”对象的开关。 //main.cpp class Stopwatch : public QObject { Q_OBJECT public: Stopwatch(); Q_INVOKABLE bool isRunning() const; public slots: void start(); void stop(); private: bool m_running; }; int main(int argc, char *argv[]) { QApplication app(argc, argv); QDeclarativeView view; view.rootContext()->setContextProperty(“stopwatch”, new Stopwatch); view.setSource(QUrl::fromLocalFile(“main.qml”)); view.show(); return app.exec(); } //main.qml import Qt 4.7 Rectangle { width: 300 height: 300 MouseArea { anchors.fill: parent onClicked: { if (stopwatch.isRunning()) stopwatch.stop() else stopwatch.start(); } } } 值得注意的是，在这个特殊的例子里有更好的方法来达到同样的效果，在main.qml有”running”属性，这将会是一个非常优秀的QML代码： // main.qml import Qt 4.7 Rectangle { MouseArea { anchors.fill: parent onClicked: stopwatch.running = !stopwatch.running } } 当然，它同样可以调用 functions declared in QML from C++。 网络组件 如果URL传递给QDeclarativeComponent是一网络资源或者QML文档引用一网络资源，QDeclarativeComponent要先获取网络数据；然后才可以创建对象。在这种情况下QDeclarativeComponent将有Loading status。直到组件调用QDeclarativeComponent::create()之前，应用程序将一直等待。 下面的例子显示如何从一个网络资源载入QML文件。在创建QDeclarativeComponent之后，它测试组件是否加载。如果是，它连接QDeclarativeComponent::statusChanged()信号，否则直接调用continueLoading()。这个测试是必要的，甚至URL都可以是远程的，只是在这种情况下要防组件是被缓存的。 MyApplication::MyApplication() { // … component = new QDeclarativeComponent(engine, QUrl(“http://www.example.com/main.qml”)); if (component->isLoading()) QObject::connect(component, SIGNAL(statusChanged(QDeclarativeComponent::Status)), this, SLOT(continueLoading())); else continueLoading(); } void MyApplication::continueLoading() { if (component->isError()) { qWarning() << component->errors(); } else { QObject *myObject = component->create(); } } Qt资源 QML的内容可以使用qrc：URL方案从Qt 资源系统载入。例如： [project/example.qrc] <!DOCTYPE RCC> <RCC version=”1.0″> <qresource prefix=”/”> <file>main.qml</file> <file>images/background.png</file> </qresource> </RCC> [project/project.pro] QT += declarative SOURCES += main.cpp RESOURCES += example.qrc [project/main.cpp] int main(int argc, char *argv[]) { QApplication app(argc, argv); QDeclarativeView view; view.setSource(QUrl(“qrc:/main.qml”)); view.show(); return app.exec(); } [project/main.qml] import Qt 4.7 Image { source: “images/background.png” } 请注意，资源系统是不能从QML直接访问的。如果主QML文件被加载作为资源，所有的文件指定在QML中做为相对路径从资源系统载入。在QML层使用资源系统是完全透明的。这也意味着，如果主QML文件没有被加载作为资源，那么从QML不能访问资源系统。 1.这里主要是介绍，如何在c++中调用QML中的函数和设置QML中的属性的问题 2.具体代码 // UICtest.qml import Qt 4.7 Rectangle { id: mainWidget; width: 640 height: 480 function callbyc(v) { mainWidget.color = v; return "finish"; } Rectangle{ id: secondRect; x: 100; y: 20; width: 400; height: 300; Rectangle{ x: 10; y: 20; width: 30; height: 40; color: "#FF035721" Text { objectName: "NeedFindObj"; anchors.fill: parent; text: ""; } } } } // main.cpp #include <QtGui/QApplication> #include <QtDeclarative/QDeclarativeView> #include <QtDeclarative/QDeclarativeEngine> #include <QtDeclarative/QDeclarativeComponent> #include <QtDeclarative/QDeclarativeContext> #include <QtDeclarative/QDeclarativeItem> #include <QMetaObject> int main(int argc, char *argv[]) { QApplication a(argc, argv); QDeclarativeView qmlView; qmlView.setSource(QUrl::fromLocalFile("../UICtest/UICtest.qml")); qmlView.show(); // 获取根节点，就是 QML中 id是mainWidget的节点 QDeclarativeItem *item = qobject_cast<QDeclarativeItem*>(qmlView.rootObject()); item->setProperty("color", QVariant("blue")); // 查找到我们需要的节点根均objectname NeedFindObj 来获得，并设置他的文本属性 QDeclarativeItem *item1 = item->findChild<QDeclarativeItem *>("NeedFindObj"); if (item1) { item1->setProperty("text", QVariant("OK")); } // 调用QML中的函数, 分别是 函数所在的对象， 函数名，返回值， 参数 QVariant returnVar; QVariant arg1 = "blue"; QMetaObject::invokeMethod(item, "callbyc", Q_RETURN_ARG(QVariant, returnVar),Q_ARG(QVariant, arg1)); qDebug(" %s",returnVar.toString().toLocal8Bit().data()); return a.exec(); } 说明： 这里的根节点是id为mainWidget的矩形元素，那么在C++中获取根节点后就可以，直接的设置他的属性了。其他属性也可以同样,调用指定节点内的函数是通过QMetaObject中的invokeMethod 来进行调用的。 最后所有关于QML和c++交互部分就基本写完，如果想要更多的东西，或者一些其他方法，强烈看看 http://doc.qt.nokia.com/4.7-snapshot/qtbinding.html，或者帮助文档，（究竟是不是我的文档里面没有还是怎么的）
C++中调用QML函数
qq_50679120的博客
04-15 483
在main.cpp中调用。在.qml中写一个函数。
第五章：C++中调用QML交互
Jason的技术探索与分享
10-26 892
实现方法： 第一步：获取QML中对象 QList<QObject*> rootObjects = engine.rootObjects(); int count = rootObjects.size(); // 找到指定对象 for(int i = 0; i < count; i++) { if(rootObjects.at(i)->objectName() == "rootObject") {
qml: C++调用qml函数
04-16 855
https://www.cnblogs.com/yinwei-space/p/9013119.html
Qt实例分析——QML调用C++方法, C++调用QML（
08-28
QML调用C++方法, C++调用QML，C++发送信号QML接收
qml 定义函数_qml: C++调用qml函数
weixin_31147827的博客
02-04 887
C++调用qml函数，是通过下面的函数实现的：bool QMetaObject::invokeMethod(QObject *obj, const char *member, Qt::ConnectionType type, QGenericReturnArgument ret,QGenericArgument val0 = QGenericArgument( Q_NULLPTR ), QGene...
【QML】与 C++ 混合编程：互相调用函数
m0_67470729的博客
01-03 1705
如题
qml调用c++类内函数的三种方法
热土程序园，利他愉己~
11-28 1563
qml调用c++类内函数的三种方法 一.方法一：使用 Q_INVOKABLE 宏声明成员函数 二.方式二：信号槽方式 三.方式三：通过Q_PROPERTY宏来实现
Qt Qml实例分析—QML调用C++方法, C++调用QML
11-25
QML调用C++方法, C++调用QML，C++发送信号QML接收
Qml与C++交互1：C++调用Qml的接口
上官宏竹的专栏
05-26 1226
Qml与C++交互1：C++调用Qml的接口1、QML接口2、C++调用3、代码4、运行结果 总体思路：qml中添加一个js函数，C++ Qt中可以使用QMetaObject::invokeMethod 来调用Js函数。 1、QML接口 给控件定义一个objectName 实现一个js函数 Text { objectName: "textLabel"; // 控件定义一个objectName text: "Hello World"; font.pixelSize: 26; Layout.lef
qml_c++互相调用
onlyfunboy的专栏
07-08 310
qml_c++互相调用 注册c++的对象到qml 1.1 注册某个类到qml 注册c++的myHttpRequest对象，到qml的引擎中； QQmlApplicationEngine engine； QScopedPointer<myHttpRequest> myHttprequest(new myHttpRequest(runMode)); engine.rootContext()->setContextProperty("myHttprequest",myHttpreque
qml与c++相互调用
深之JohnChen的专栏
04-14 2580
一、qml调用C++ 转载https://blog.csdn.net/iceboy314159/article/details/79189514 在qml中调用c++ (类成员，成员函数)，在官方文档中有详细描述，地址如下： http://doc.qt.io/qt-5/qtqml-cppintegration-exposecppattributes.html 这里尽可能简单的总结一下，只说...
QML-C++直接调用qml函数
weixin_60819724的博客
07-04 233
【代码】QML-C++直接调用qml函数。
22. QML与C++交互---C++调用QML中的函数
山间点烟雨
02-24 1109
在QML与C++混合开发时，QML界面元素可以通过某种方式去调用C++中的函数，但是，在某种情况下也需要在C++端去调用QML中定义的函数，完成相应的功能，本篇文章将简单介绍几种方式进行实现。
c++调用qml中函数的例子
qq_43248127的博客
10-23 345
engine.load(QUrl(QStringLiteral("qrc:/main.qml"))); QObject *pMsgBox = engine.rootObjects().first()->findChild<QObject*>("msgBox"); if(pMsgBox != Q_NULLPTR){ QVariant qmlFuncRet; bool ret = QMetaObject::invokeMethod(pM...
C++和QML混合编程_C++直接调用QML函数
会选科技的博客
08-31 964
C++和QML混合编程_C++直接调用QML函数
Qt QML与C++双向调用技术解析
C++调用QML函数主要分为以下步骤： a. 在QML中定义一个对象，并且将其声明为可访问的上下文属性或单例对象。 b. 在C++代码中，通过`QQmlEngine`和`QQmlComponent`类来处理QML文件，创建出QML对象的实例。 c. 利用...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值