C++扩展QML

C++扩展QML

QML执⾏在受限的空间中，QML作为⼀种语⾔提供的功能有时是被限制的。
通过C++写的本地函数可以扩展QML运⾏时的功能。应⽤程序可以充分利⽤
基础平台的性能和⾃由度。

理解QML运行环境

当运行QML时，他会在一个由QtQml模块下的C++代码实现的运行环境中执行。它由一个负责执行QML的引擎，持有访问每个组件属性的上下文和实例化的QML元素组件构成。

#include <QtGui>
#include <QtQml>

int main(int argc, char **argv)
{
   
		QGuiApplication app(argc, argv);
		QUrl source(QStringLiteral("qrc:/main.qml"));
		QQmlApplicationEngine engine;
		engine.load(source);
	
		return app.exec();
}

在这个例子中，QGuiApplication封装了所有与应用程序引用相关的属性（例如应⽤程序名称，命令⾏参数，和事件循环管理）。 QQmlApplicationEngine 分层管理上下⽂和组件的顺序。它需要加载⼀个典型的qml⽂件作为应⽤程序的开始点。在这个例⼦中， main.qml 包含了以⼀个窗⼝和⼀个⽂本。
注：
通过 QmlApplicationEngine 加载⼀个使⽤简单项作为根类型的 main.qml 不会在你的屏幕上显⽰任何东⻄，它需要⼀个窗⼝来管理⼀个平⾯的渲染。引擎可以加载不包含任何⽤户界⾯的qml代码（例如⼀个纯粹的对象）。由于它不会默认为你创建⼀个窗⼝。 qmlcene 或者新的qml运⾏环境将会在内部⾸先检查 main.qml ⽂件是否包含⼀个窗⼝作为根项，如果没有包含将会为你创建⼀个并且设置根项作为新创建窗⼝的⼦项。

import QtQuick 2.4
import QtQuick.Window 2.0

Window {
		visible: true
		width: 512
		height: 300
		Text {
				anchors.centerIn: parent
				text: "Hello World!"
				}
}

在QML文件中我们定义的依赖是QtQuick和QtQuick.Window。这些定义将会在导入的路径查找这些模块，并在加载成功后由引擎加载需要的插件。新加载的类型将会被qmldir控制在qml文件中可用。

当然也可以用快速创建插件直接向引擎添加我们的自定义类型。这里我们假设有一个基于QObject的CurrentTime类。

QQmlApplicationEngine engine;
qmlRegisterType<CurrentTime>("org.example", 1, 0, "CurrentTime");
engine.load(source);

现在我们也可以在qml文件中使用CurrentTime类型

import org.example 1.0
CurrentTime {
   
		// access properties, functions, signals
}

还有一种更方便的方式是通过上下文属性直接设置

QScopedPointer<CurrentTime> current(new CurrentTime