当将QML对象加载到c++应用程序中时,直接嵌入一些可以从QML代码中使用的c++数据可能会很有用。这使得在嵌入式对象上调用c++方法,或者使用c++对象实例作为QML视图的数据模型成为可能
通过QQmlContext类,可以将c++数据注入到QML对象中。这个类将数据公开给QML对象的上下文,以便可以直接从QML代码范围内引用数据。
1.设置简单上下文属性
例如,下面是一个QML项,它引用了当前范围内不存在的currentDateTime值:
// MyItem.qml
import QtQuick 2.0
Text { text: currentDateTime }
这个currentDateTime值可以通过加载QML组件的c++应用程序直接设置,使用QQmlContext::setContextproperty():
qquickview view;
view.rootContext()->setContextProperty("currentDateTime", QDateTime::currentDateTime());
view.setSource(QUrl::fromLocalFile("MyItem.qml"));
view.show();
注意:由于在QML中计算的所有表达式都是在特定上下文中计算的,如果上下文被修改,那么该上下文中的所有绑定都将被重新计算。因此,应该在应用程序初始化之外小心使用上下文属性,因为这可能会导致应用程序性能下降
2.将对象设置为上下文属性
上下文属性可以保存QVariant或QObject*值。这意味着定制的c++对象也可以使用这种方法注入,并且可以在QML中直接修改和读取这些对象。这里,我们修改上面的示例以嵌入一个QObject实例而不是一个QDateTime值,并且QML代码调用对象实例上的一个方法
class ApplicationData : public QObject
{
Q_OBJECT
public:
Q_INVOKABLE QDateTime getCurrentDateTime() const {
return QDateTime::currentDateTime();
}
};
int main(int argc, char *argv[]) {
QGuiApplication app(argc, argv);
qquickview view;
ApplicationData data;
view.rootContext()->setContextProperty("applicationData", &data);
view.setSource(QUrl::fromLocalFile("MyItem.qml"));
view.show();
return app.exec();
}
qml:
// MyItem.qml
import QtQuick 2.0
Text { text: applicationData.getCurrentDateTime() }
(请注意,从c++返回到QML的日期/时间值可以通过Qt.formatDateTime()和相关函数进行格式化。)
如果QML项目需要接收来自上下文属性的信号,它可以使用Connections类型连接到它们。例如,如果ApplicationData有一个名为datachchanged()的信号,这个信号可以在Connections对象中使用ondatachchanged处理程序连接到:
Text {
text: applicationData.getCurrentDateTime()
Connections {
target: applicationData
onDataChanged: console.log("The application data changed!")
}
}
上下文属性对于在QML视图中使用基于c++的数据模型非常有用。请看下面的例子:
演示了QStringList, QList<QObject*>模型和qabstractitemmodel在QML视图中的使用。