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 作为parent 的子对象构建一个 QQuickWidget。

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

用默认的 QML 引擎和给定的 QMLsource 作为parent 的子节点构造一个 QQuickWidget。

parent 的默认值是nullptr 。

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

用uri 和typeName 指定的元素以及父对象parent 构建一个 QQuickWidget。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 。如果您想使用QQuickWindow API，而QQuickWidget 当前并未公开这些 API，例如，连接到QQuickWindow::beforeRendering() 信号，以便在Qt Quick'自己的渲染下面绘制本地 OpenGL 内容，这将非常有用。

QQmlContext *QQuickWidget::rootContext() const

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

QQuickItem *QQuickWidget::rootObject() const

返回视图的根item 。如果setSource() 未被调用、调用时使用了已损坏的QtQuick 代码或正在创建QtQuick 内容，则返回值可能为空。

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

当场景图初始化过程中出现error 时，将发出该信号。

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

该信号将从图形用户界面线程中发出。

另请参见 QQuickWindow::sceneGraphError().

void QQuickWidget::setClearColor(const QColor &color)

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

要获得半透明的QQuickWidget ，请在将color 设置为Qt::transparent 的情况下调用此函数，在顶层窗口上设置Qt::WA_TranslucentBackground widget 属性，并通过setFormat() 申请 alpha 通道。

另请参阅 QQuickWindow::setColor()。

void QQuickWidget::setFormat(const QSurfaceFormat &format)

设置此部件使用的上下文和离屏表面的表面format 。

当需要为给定的 OpenGL 版本或配置文件请求上下文时，请调用此函数。深度、模板和 alpha 缓冲区的大小会自动处理，无需明确请求。

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

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

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

此函数在 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).