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)

创建一个 QQuickView，其元素由uri 和typeName 指定，父对象为parent 。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 对于向 QML 组件传递数据至关重要。在 QML 中，上下文按层次结构排列，该层次结构由QQmlEngine 管理。

QQuickItem *QQuickView::rootObject() const

返回视图的根item 。

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

设置初始属性initialProperties ，QML组件在调用QQuickView::setSource()后将以此进行初始化。

    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 发生变化时，会发出此信号。