QQuickView Class

成员函数文档

[explicit] QQuickView::QQuickView(QWindow *parent = nullptr)

用给定的parent 构建一个 QQuickView。parent 的默认值为 0。

QQuickView::QQuickView(QQmlEngine *engine, QWindow *parent)

用给定的 QMLengine 和parent 构建一个 QQuickView。

注：在这种情况下，QQuickView 并不拥有给定的engine 对象；销毁引擎是调用者的责任。如果engine 在视图之前被删除，status() 将返回QQuickView::Error 。

另请参阅 Status,status() 和errors() 。

[explicit] QQuickView::QQuickView(const QUrl &source, QWindow *parent = nullptr)

使用给定的 QMLsource 和parent 构建一个 QQuickView。parent 的默认值是nullptr 。

[explicit, since 6.7] QQuickView::QQuickView(QAnyStringView uri, QAnyStringView typeName, QWindow *parent = nullptr)

用uri 和typeName 指定的元素以及父级parent 构建一个 QQuickView。parent 的默认值是nullptr 。

此函数在 Qt 6.7 中引入。

另请参阅 loadFromModule 。

[override virtual noexcept] QQuickView::~QQuickView()

摧毁QQuickView.

QQmlEngine *QQuickView::engine() const

返回用于实例化 QML 组件的QQmlEngine 指针。

QList<QQmlError> QQuickView::errors() const

返回上次编译或创建操作中出现的错误列表。如果状态不是 Error，则返回空列表。

QSize QQuickView::initialSize() const

返回根对象的初始大小。

如果resizeMode 是 QQuickItem::SizeRootObjectToView，根对象的大小将调整为视图的大小。initialSize 包含根对象调整大小前的大小。

[override virtual protected] void QQuickView::keyPressEvent(QKeyEvent *e)

重实现：QQuickWindow::keyPressEvent(QKeyEvent *e)。

[override virtual protected] void QQuickView::keyReleaseEvent(QKeyEvent *e)

重实现：QQuickWindow::keyReleaseEvent(QKeyEvent *e)。

[slot, since 6.7] void QQuickView::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

加载由uri 和typeName 标识的 QML 组件。如果组件由 QML 文件支持，source 将相应设置。对于C++ 中定义的类型，source 将为空。

如果在调用此方法之前设置了source ，则会被清除。

使用相同的uri 和typeName 多次调用此方法将导致 QML 组件被重新初始化。

此函数在 Qt 6.7 中引入。

另请参阅 setSource,QQmlComponent::loadFromModule, 和QQmlApplicationEngine::loadFromModule 。

[override virtual protected] void QQuickView::mouseMoveEvent(QMouseEvent *e)

重实现：QQuickWindow::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QQuickView::mousePressEvent(QMouseEvent *e)

重实现：QQuickWindow::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QQuickView::mouseReleaseEvent(QMouseEvent *e)

重实现：QQuickWindow::mouseReleaseEvent(QMouseEvent *event).

QQmlContext *QQuickView::rootContext() const

该函数返回上下文层次结构的根。每个 QML 组件都在QQmlContext 中实例化。QQmlContext's 是向 QML 组件传递数据的关键。在 QML 中，上下文按层次排列，这种层次结构由QQmlEngine 管理。

QQuickItem *QQuickView::rootObject() const

返回视图的根item 。

[slot] void QQuickView::setInitialProperties(const QVariantMap &initialProperties)

设置 QML 组件在调用QQuickView::setSource() 后初始化的初始属性initialProperties 。

    QScopedPointer<QQuickView> view { new QQuickView };
    view->setInitialProperties({"x, 100"}, {"width", 50});
    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();

另请参阅 QQmlComponent::createWithInitialProperties() 。

[slot] void QQuickView::setSource(const QUrl &url)

将源设置为url ，加载 QML 组件并将其实例化。

确保提供的 URL 完整、正确，特别是从本地文件系统加载文件时，请使用QUrl::fromLocalFile() 。

使用相同的 URL 多次调用此方法，将导致 QML 组件被重新实例化。

另请参阅 source() 。

QUrl QQuickView::source() const

如果已设置，返回源 URL。

另请参阅 setSource().

[signal] void QQuickView::statusChanged(QQuickView::Status status)

该信号在组件当前status 发生变化时发出。