Qt：Qt QML类

向右看齐 2022-10-25 01:17 253阅读 0赞

> Qt QML模块提供的C ++ API

# 引入 #

1、创建一个控制台应用程序

2、在qmake.pro中加入如下信息：

QT + = qml

3、为包含模块类的定义，需要引入头文件，

#include <QtQml>

4、运行效果

![20210311171921356.png][]

# 命名空间 #

![20210311172006680.png][]

## QtQML ##

> **功能：**
> 
>  *  提供用于生成QML类型的日志消息的功能
> 
> <table style="width:500px;"> 
>  <tbody> 
>   <tr> 
>    <td>头文件</td> 
>    <td>#include &lt;QtQml&gt;</td> 
>   </tr> 
>   <tr> 
>    <td>qmake：</td> 
>    <td>QT + = qml</td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> **函数：**
> 
> ![20210311172313272.png][]
> 
> **官方文档**：[https://doc.qt.io/qt-5/qtqml.html][https_doc.qt.io_qt-5_qtqml.html]

# 类 #

## QJSEngine类 ##

> **功能：**
> 
>  *  QJSEngine类提供了一个用于评估JavaScript代码的环境
> 
> <table style="width:500px;"> 
>  <tbody> 
>   <tr> 
>    <td>头文件</td> 
>    <td>#include &lt;QJSEngine&gt;</td> 
>   </tr> 
>   <tr> 
>    <td>qmake：</td> 
>    <td>QT + = qml</td> 
>   </tr> 
>   <tr> 
>    <td>引入</td> 
>    <td>Qt 5.0</td> 
>   </tr> 
>   <tr> 
>    <td>继承自</td> 
>    <td><a href="https://doc.qt.io/qt-5/qobject.html" rel="nofollow">QObject</a></td> 
>   </tr> 
>   <tr> 
>    <td>继承者</td> 
>    <td><a href="https://doc.qt.io/qt-5/qqmlengine.html" rel="nofollow">QQmlEngine</a></td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> **官方文档： [https://doc.qt.io/qt-5/qjsengine.html][https_doc.qt.io_qt-5_qjsengine.html]**

### evaluate ###

> **原型：**
> 
>     QJSValue evaluate(const QString &program, const QString &fileName = QString(), int lineNumber = 1);
> 
> **功能：**
> 
>  *  评估脚本代码
> 
> **示例：**
> 
>  *  测试脚本代码是否能够运行
> 
>     QJSEngine myEngine;
>         QJSValue three = myEngine.evaluate("1 + 2");
>         qInfo() << three.toInt();
> 
>  *  定义脚本函数，然后使用[QJSValue :: call][QJSValue _ call]（）从C ++调用该脚本函数：
> 
>     QJSEngine myEngine;
>         QJSValue fun = myEngine.evaluate("(function(a, b) { return a + b; })");
>         QJSValueList args;
>         args << 1 << 2;
>         QJSValue threeAgain = fun.call(args);
>         qInfo() << threeAgain.toInt();
> 
>  *  从上面的代码片段可以看出，脚本以字符串的形式提供给引擎。另外我们还可以从文件中读取脚本
> 
> （1）helloworld.qs的内容：
> 
> ![20210311174146635.png][]
> 
> （2）qt中代码：
> 
>     QJSEngine myEngine;
>     
>         QString fileName = "C:/Users/oceanstar/Downloads/helloworld.qs";
>         QFile scriptFile(fileName);
>         if (!scriptFile.open(QIODevice::ReadOnly)){
>            // handle error
>             qInfo() << "open error";
>             return -1;
>         }
>     
>         QTextStream stream(&scriptFile);
>         QString contents = stream.readAll();
>         scriptFile.close();
>         QJSValue three =myEngine.evaluate(contents, fileName);
>         qInfo() << three.toInt();
> 
> 官方文档：[https://doc.qt.io/qt-5/qjsengine.html\#QJSEngine-1][https_doc.qt.io_qt-5_qjsengine.html_QJSEngine-1]

## QJSValue类 ##

> **功能：**
> 
>  *  QJSValue类充当Qt / JavaScript数据类型的容器
> 
> <table style="width:500px;"> 
>  <tbody> 
>   <tr> 
>    <td>头文件</td> 
>    <td>#include &lt;QJSValue&gt;</td> 
>   </tr> 
>   <tr> 
>    <td>qmake：</td> 
>    <td>QT + = qml</td> 
>   </tr> 
>   <tr> 
>    <td>引入</td> 
>    <td>Qt 5.0</td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> **官方文档： [https://doc.qt.io/qt-5/qjsvalue.html][https_doc.qt.io_qt-5_qjsvalue.html]**

## QJSValueIterator类 ##

> **功能：**
> 
>  *  该QJSValueIterator类提供了一个Java风格的迭代[QJSValue][https_doc.qt.io_qt-5_qjsvalue.html]
> 
> <table style="width:500px;"> 
>  <tbody> 
>   <tr> 
>    <td>头文件</td> 
>    <td>#include &lt;QJSValueIterator&gt;</td> 
>   </tr> 
>   <tr> 
>    <td>qmake：</td> 
>    <td>QT + = qml</td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> **官方文档： [https://doc.qt.io/qt-5/qjsvalueiterator.html][https_doc.qt.io_qt-5_qjsvalueiterator.html]**

## QQmlAbstractUrlInterceptor接口 ##

> **功能：**
> 
>  *  控制QML文件加载
> 
> <table style="width:500px;"> 
>  <tbody> 
>   <tr> 
>    <td>头文件</td> 
>    <td>#include &lt;QQmlAbstractUrlInterceptor&gt;</td> 
>   </tr> 
>   <tr> 
>    <td>qmake：</td> 
>    <td>QT + = qml</td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> **详细说明：**
> 
>  *  QQmlAbstractUrlInterceptor是一个接口，可用于在QML引擎使用URL之前更改URL。这主要用于将文件url更改为其他文件url，例如为当前平台选择不同的图形资产。
>  *  根据当前QML上下文的文件路径解析相对URL后，将对其进行拦截。为已加载的QML文件设置基本路径后，也会发生URL拦截。这意味着为该QML文件加载的内容使用了截获的URL，但是在文件内部，预截取的URL用于解析相对路径。这允许截取.qml文件，而无需在截取的内容内的所有路径（或本地类型）插入不同的相对路径。
>  *  与setNetworkAccessManagerFactory相比，QQmlAbstractUrlInterceptor影响所有URL和路径，包括本地文件和嵌入式资源文件。QQmlAbstractUrlInterceptor是同步的，对于异步文件，必须使用异步方案（例如http或由您自己的自定义QNetworkAccessManager处理的自定义方案）返回url。您可以使用QQmlAbstractUrlInterceptor将文件URL更改为网络URL，这些URL由您自己的自定义QNetworkAccessManager处理。
>  *  要实现对自定义网络方案的支持，请参见setNetworkAccessManagerFactory。
> 
> **官方文档： [https://doc.qt.io/qt-5/qjsvalueiterator.html][https_doc.qt.io_qt-5_qjsvalueiterator.html]**

## QQmlApplicationEngine类 ##

> **功能：**
> 
>  *  QQmlApplicationEngine提供了一种从单个QML文件加载应用程序的便捷方法
> 
> <table style="width:500px;"> 
>  <tbody> 
>   <tr> 
>    <td>头文件</td> 
>    <td>#include &lt;QQmlApplicationEngine&gt;</td> 
>   </tr> 
>   <tr> 
>    <td>qmake：</td> 
>    <td>QT + = qml</td> 
>   </tr> 
>   <tr> 
>    <td>引入</td> 
>    <td>Qt 5.0</td> 
>   </tr> 
>   <tr> 
>    <td>继承自</td> 
>    <td><a href="https://doc.qt.io/qt-5/qobject.html" rel="nofollow">QObject</a></td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> **详细说明：**
> 
>  *  此类结合了[QQmlEngine][]和[QQmlComponent][]来提供一种方便的方式来加载单个QML文件。它还向QML公开了一些中央应用程序功能，而C ++ / QML混合应用程序通常会从C ++控制这些功能。
> 
> **官方文档： [https://doc.qt.io/qt-5/qqmlapplicationengine.html][https_doc.qt.io_qt-5_qqmlapplicationengine.html]**

[20210311171921356.png]: /images/20221024/2d48967dda3349769470f512e0fdbe9b.png
[20210311172006680.png]: /images/20221024/c329c80cc5664e55a121e709c3373320.png
[20210311172313272.png]: /images/20221024/a42514ae58bb4d3491c0388896ce0edd.png
[https_doc.qt.io_qt-5_qtqml.html]: https://doc.qt.io/qt-5/qtqml.html
[https_doc.qt.io_qt-5_qjsengine.html]: https://doc.qt.io/qt-5/qjsengine.html
[QJSValue _ call]: https://doc.qt.io/qt-5/qjsvalue.html#call
[20210311174146635.png]: /images/20221024/ef78d75de8984d9b8bc16a1115d74196.png
[https_doc.qt.io_qt-5_qjsengine.html_QJSEngine-1]: https://doc.qt.io/qt-5/qjsengine.html#QJSEngine-1
[https_doc.qt.io_qt-5_qjsvalue.html]: https://doc.qt.io/qt-5/qjsvalue.html
[https_doc.qt.io_qt-5_qjsvalueiterator.html]: https://doc.qt.io/qt-5/qjsvalueiterator.html
[QQmlEngine]: https://doc.qt.io/qt-5/qqmlengine.html
[QQmlComponent]: https://doc.qt.io/qt-5/qqmlcomponent.html
[https_doc.qt.io_qt-5_qqmlapplicationengine.html]: https://doc.qt.io/qt-5/qqmlapplicationengine.html