QQuickView类

成员函数文档

[显式] QQuickView::QQuickView(QWindow *父 = nullptr)

使用给定的父构建QQuickView。默认父值是0。

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

使用给定的QMLengine和父构建QQuickView。

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

另请参阅状态、状态()和错误。

[显式，自6.7以来] QQuickView::QQuickView(QUrl &source, QWindow *父 = nullptr)

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

[显式，自6.7以来] QQuickView::QQuickView(QAnyStringView uri, QAnyStringView typeName, QWindow *父 = nullptr)

使用由uri和typeName指定的元素和父父构建QQuickView。默认父值是nullptr。

此函数是在Qt 6.7中引入的。

另请参阅从模块加载。

[重写虚拟 noexcept] QQuickView::~QQuickView()

销毁QQuickView。

QQmlEngine *QQuickView::engine() const

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

QList<QQmlError> QQuickView::errors() const

返回上次编译或创建操作期间发生的错误的列表。当状态不是Error时，返回空列表。

QSize QQuickView::initialSize() const

返回根对象的最小大小。

如果 resizeMode 设置为 QQuickItem::SizeRootObjectToView，则根对象将根据视图大小进行调整。initialSize 包含调整大小前的根对象大小。

[覆盖虚保护] void QQuickView::keyPressEvent(QKeyEvent *e)

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

[覆盖虚保护] void QQuickView::keyReleaseEvent(QKeyEvent *e)

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

[槽，自 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。

[覆盖虚保护] void QQuickView::mouseMoveEvent(QMouseEvent *e)

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

[覆盖虚保护] void QQuickView::mousePressEvent(QMouseEvent *e)

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

[覆盖虚保护] void QQuickView::mouseReleaseEvent(QMouseEvent *e)

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

QQmlContext *QQuickView::rootContext() const

此函数返回上下文层次结构的根。每个 QML 组件都在一个 QQmlContext 中实例化。上下文是用于传递数据到 QML 组件的关键。在 QML 中，上下文按层级排列，该层级由 QQmlEngine 管理。

QQuickItem *QQuickView::rootObject() const

返回视图的根 项目。

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

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

    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 改变时，此信号被发出。