QQuickWidget Class

QQuickWidget *view = new QQuickWidget;
view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
view->show();

成员函数文档

[explicit] QQuickWidget::QQuickWidget(QWidget *parent = nullptr)

创建一个使用默认 QML 引擎的 QQuickWidget，并将其作为parent 的子控件。

parent 的默认值为nullptr 。

QQuickWidget::QQuickWidget(QQmlEngine *engine, QWidget *parent)

根据给定的 QMLengine 创建一个 QQuickWidget，将其作为parent 的子控件。

[explicit] QQuickWidget::QQuickWidget(const QUrl &source, QWidget *parent = nullptr)

创建一个 QQuickWidget，使用默认的 QML 引擎，并将给定的 QMLsource 作为parent 的子控件。

parent 的默认值为nullptr 。

[explicit, since 6.9] QQuickWidget::QQuickWidget(QAnyStringView uri, QAnyStringView typeName, QWidget *parent = nullptr)

创建一个 QQuickWidget，其元素由 `uri ` 和 `typeName ` 指定，父对象为 `parent`。`parent ` 的默认值为 `nullptr`。

该函数在 Qt 6.9 中引入。

另请参阅 loadFromModule 。

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

销毁QQuickWidget 。

[override virtual protected] void QQuickWidget::dragEnterEvent(QDragEnterEvent *e)

重写：QWidget::dragEnterEvent(QDragEnterEvent *event)。

[override virtual protected] void QQuickWidget::dragLeaveEvent(QDragLeaveEvent *e)

重写了：QWidget::dragLeaveEvent(QDragLeaveEvent *event)。

[override virtual protected] void QQuickWidget::dragMoveEvent(QDragMoveEvent *e)

重写了：QWidget::dragMoveEvent(QDragMoveEvent *event)。

[override virtual protected] void QQuickWidget::dropEvent(QDropEvent *e)

重写了：QWidget::dropEvent(QDropEvent *event)。

QQmlEngine *QQuickWidget::engine() const

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

QList<QQmlError> QQuickWidget::errors() const

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

另请参阅 status 。

[override virtual protected] bool QQuickWidget::event(QEvent *e)

重写了：QWidget::event(QEvent *event)。

[override virtual protected] void QQuickWidget::focusInEvent(QFocusEvent *event)

重写了：QWidget::focusInEvent(QFocusEvent *event)。

[override virtual protected] bool QQuickWidget::focusNextPrevChild(bool next)

重新实现了：QWidget::focusNextPrevChild （bool next）。

[override virtual protected] void QQuickWidget::focusOutEvent(QFocusEvent *event)

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

QSurfaceFormat QQuickWidget::format() const

返回实际的表面格式。

如果该控件尚未显示，则返回请求的格式。

另请参阅 setFormat()。

QImage QQuickWidget::grabFramebuffer() const

渲染一帧并将其读回图像中。

[override virtual protected] void QQuickWidget::hideEvent(QHideEvent *)

重写了：QWidget::hideEvent(QHideEvent *event)。

QSize QQuickWidget::initialSize() const

返回根对象的初始大小。

如果resizeMode 的值为SizeRootObjectToView ，则根对象将调整为视图的大小。该函数返回根对象在调整大小之前的大小。

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

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

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

重写了：QWidget::keyReleaseEvent(QKeyEvent *event)。

[slot, since 6.9] void QQuickWidget::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

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

如果在调用此方法之前已设置任何source ，则该值将被清空。

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

此函数在 Qt 6.9 中引入。

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

[override virtual protected] void QQuickWidget::mouseDoubleClickEvent(QMouseEvent *e)

重写了：QWidget::mouseDoubleClickEvent(QMouseEvent *event)。

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

重写了：QWidget::mouseMoveEvent(QMouseEvent *event)。

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

重写了：QWidget::mousePressEvent(QMouseEvent *event)。

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

重写了：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] void QQuickWidget::paintEvent(QPaintEvent *event)

重写了：QWidget::paintEvent(QPaintEvent *event)。

QQuickWindow *QQuickWidget::quickWindow() const

返回该控件用于驱动Qt Quick 渲染的离屏QQuickWindow 。如果您希望使用QQuickWidget 当前尚未公开的QQuickWindow API（例如，连接到QQuickWindow::beforeRendering() 信号，以便在Qt Quick 自身的渲染层下方绘制原生 OpenGL 内容），此功能将非常有用。

QQmlContext *QQuickWidget::rootContext() const

该函数返回上下文层次结构的根节点。每个 QML 组件都会在QQmlContext 中实例化。QQmlContext 对于将数据传递给 QML 组件至关重要。在 QML 中，上下文按层次结构排列，该层次结构由QQmlEngine 管理。

QQuickItem *QQuickWidget::rootObject() const

返回视图的根item 。当未调用setSource()时，或调用时QtQuick 代码存在错误，或者根项因其他原因未定义时，该值可能是nullptr 。

[signal] void QQuickWidget::sceneGraphError(QQuickWindow::SceneGraphError error, const QString &message)

当在场景图初始化过程中发生error 时，会发出此信号。

如果应用程序希望以自定义方式处理错误（例如 OpenGL 上下文创建失败），应连接此信号。若未将任何槽连接到该信号，则行为将有所不同：Quick 会打印message ，或显示一个消息框，并终止应用程序。

该信号将由GUI线程发出。

另请参阅 QQuickWindow::sceneGraphError()。

void QQuickWidget::setClearColor(const QColor &color)

设置透明的color 。默认情况下，该颜色是不透明的。

若要获得半透明的QQuickWidget ，请在调用此函数时将color 设置为Qt::transparent ，在顶级窗口上设置Qt::WA_TranslucentBackground 控件属性，并通过setFormat()请求Alpha通道。

另请参阅 QQuickWindow::setColor()。

void QQuickWidget::setFormat(const QSurfaceFormat &format)

为该控件所使用的上下文和离屏表面设置表面format 。

当需要为给定的 OpenGL 版本或配置文件请求上下文时，请调用此函数。深度、模板和透明度缓冲区的尺寸将自动处理，无需显式请求。

另请参阅 QWindow::setFormat()、QWindow::format() 和format()。

[slot, since 6.9] void QQuickWidget::setInitialProperties(const QVariantMap &initialProperties)

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

此函数在 Qt 6.9 中引入。

另请参阅 QQmlComponent::createWithInitialProperties()。

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

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

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

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

另请参阅 source()。

[override virtual protected] void QQuickWidget::showEvent(QShowEvent *)

重写了：QWidget::showEvent(QShowEvent *event)。

QUrl QQuickWidget::source() const

返回源 URL（如果已设置）。

另请参阅 setSource()。

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

当组件的当前status 发生变化时，会发出此信号。

[override virtual protected] void QQuickWidget::wheelEvent(QWheelEvent *e)

重写了：QWidget::wheelEvent(QWheelEvent *event)。