第四篇 QML代码与现有Qt UI代码整合



有很多方式可将QML整合到基于QWidget UI应用程序中,具体方案依赖于UI代码的特征.

与基于QWidget的UI整合

如果有一个基于QWidge的UI界面,可使用QDeclarativeView整合QML部件.QDeclarativeView继承于QWidget,因此可像其他QWidget部件一样添加到用户界面中. 使用 QDeclarativeView::setSource()向视图中加载QML文件,并将视图添加到UI中:

 QDeclarativeView *qmlView = new QDeclarativeView;
 qmlView->setSource(QUrl::fromLocalFile("myqml.qml"));

 QWidget *widget = myExistingWidget();
 QVBoxLayout *layout = new QVBoxLayout(widget);
 layout->addWidget(qmlView);

这种方式的缺点是 QDeclarativeView初始化速度慢,而且比QWidget占用更多内存,创建大量的 QDeclarativeView会使性能下降.这时最好在QML中重写部件,并使用主QML部件加载这些部件,替换掉 QDeclarativeView.

要知道QWidget相对于QML是不同的用户界面类型,因此有时将基于QWidget的应用程序转化为QML是不妥的.QWidget应该用于UI中有大量复杂且静止元素的情形,而QML则用于UI中有大量简单动态元素的情形.

与基于QGraphicsView的UI程序整合

向QGraphicScene中添加QML部件

如果有一个基于图形视图框架(Graphics View Framework)的UI程序,可直接将QML部件整合到 QGraphicsScene.使用QDeclarativeComponent 从QML文件创建一个 QGraphicsObject,再使用QGraphicsScene::addItem()将这个图像对象添加到场景,或替换场景中已存的项目.

例如:

 QGraphicsScene* scene = myExistingGraphicsScene();
 QDeclarativeEngine *engine = new QDeclarativeEngine;
 QDeclarativeComponent component(engine, QUrl::fromLocalFile("myqml.qml"));
 QGraphicsObject *object =
     qobject_cast<QGraphicsObject *>(component.create());
 scene->addItem(object);

如下QGraphicView选项用来优化QML界面效率:

• QGraphicsView::setOptimizationFlags(QGraphicsView::DontSavePainterState)
• QGraphicsView::setViewportUpdateMode(QGraphicsView::BoundingRectViewportUpdate)
• QGraphicsScene::setItemIndexMethod(QGraphicsScene::NoIndex)

在QML中加载QGraphicsWidget对象

另一种方式是在QML中应用已存的QGraphicWidget对象,现在需要构建一个基于QML的场景.在范例graphics layouts example中展示如何在QML中加载Qt图像布局类型,以便于在配合QGraphicsLinearLayout 和QGraphicsGridLayout使用QGraphicsWidget .

在QML中显示QGraphicsWidget 类,需要使用qmlRegisterType().范例Extending QML Functionalities using C++展示更多在QML中使用C++的信息.