QQuickWidget Class

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

Member Function Documentation

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

Constructs a QQuickWidget with a default QML engine as a child of parent.

The default value of parent is nullptr.

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

Constructs a QQuickWidget with the given QML engine as a child of parent.

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

Constructs a QQuickWidget with a default QML engine and the given QML source as a child of parent.

The default value of parent is nullptr.

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

Constructs a QQuickWidget with the element specified by uri and typeName and parent parent. The default value of parent is nullptr.

This function was introduced in Qt 6.9.

See also loadFromModule.

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

Destroys the QQuickWidget.

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

Reimplements: QWidget::dragEnterEvent(QDragEnterEvent *event).

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

Reimplements: QWidget::dragLeaveEvent(QDragLeaveEvent *event).

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

Reimplements: QWidget::dragMoveEvent(QDragMoveEvent *event).

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

Reimplements: QWidget::dropEvent(QDropEvent *event).

QQmlEngine *QQuickWidget::engine() const

Returns a pointer to the QQmlEngine used for instantiating QML Components.

QList<QQmlError> QQuickWidget::errors() const

Return the list of errors that occurred during the last compile or create operation. When the status is not Error, an empty list is returned.

See also status.

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

Reimplements: QWidget::event(QEvent *event).

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

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplements: QWidget::focusNextPrevChild(bool next).

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

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

QSurfaceFormat QQuickWidget::format() const

Returns the actual surface format.

If the widget has not yet been shown, the requested format is returned.

See also setFormat().

QImage QQuickWidget::grabFramebuffer() const

Renders a frame and reads it back into an image.

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

Reimplements: QWidget::hideEvent(QHideEvent *event).

QSize QQuickWidget::initialSize() const

Returns the initial size of the root object.

If resizeMode is SizeRootObjectToView, the root object will be resized to the size of the view. This function returns the size of the root object before it was resized.

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

Reimplements: QWidget::keyPressEvent(QKeyEvent *event).

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

Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).

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

Loads the QML component identified by uri and typeName. If the component is backed by a QML file, source will be set accordingly. For types defined in C++, source will be empty.

If any source was set before this method was called, it will be cleared.

Calling this method multiple times with the same uri and typeName will result in the QML component being reinstantiated.

This function was introduced in Qt 6.9.

See also setSource, QQmlComponent::loadFromModule, and QQmlApplicationEngine::loadFromModule.

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

Reimplements: QWidget::mouseDoubleClickEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).

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

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

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

Reimplements: QWidget::paintEvent(QPaintEvent *event).

QQuickWindow *QQuickWidget::quickWindow() const

Returns the offscreen QQuickWindow which is used by this widget to drive the Qt Quick rendering. This is useful if you want to use QQuickWindow APIs that are not currently exposed by QQuickWidget, for instance connecting to the QQuickWindow::beforeRendering() signal in order to draw native OpenGL content below Qt Quick's own rendering.

QQmlContext *QQuickWidget::rootContext() const

This function returns the root of the context hierarchy. Each QML component is instantiated in a QQmlContext. QQmlContext's are essential for passing data to QML components. In QML, contexts are arranged hierarchically and this hierarchy is managed by the QQmlEngine.

QQuickItem *QQuickWidget::rootObject() const

Returns the view's root item. Can be null when setSource() has not been called, if it was called with broken QtQuick code or while the QtQuick contents are being created.

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

This signal is emitted when an error occurred during scene graph initialization.

Applications should connect to this signal if they wish to handle errors, like OpenGL context creation failures, in a custom way. When no slot is connected to the signal, the behavior will be different: Quick will print the message, or show a message box, and terminate the application.

This signal will be emitted from the GUI thread.

See also QQuickWindow::sceneGraphError().

void QQuickWidget::setClearColor(const QColor &color)

Sets the clear color. By default this is an opaque color.

To get a semi-transparent QQuickWidget, call this function with color set to Qt::transparent, set the Qt::WA_TranslucentBackground widget attribute on the top-level window, and request an alpha channel via setFormat().

See also QQuickWindow::setColor().

void QQuickWidget::setFormat(const QSurfaceFormat &format)

Sets the surface format for the context and offscreen surface used by this widget.

Call this function when there is a need to request a context for a given OpenGL version or profile. The sizes for depth, stencil and alpha buffers are taken care of automatically and there is no need to request those explicitly.

See also QWindow::setFormat(), QWindow::format(), and format().

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

Sets the initial properties initialProperties with which the QML component gets initialized after calling QQuickWidget::setSource().

This function was introduced in Qt 6.9.

See also QQmlComponent::createWithInitialProperties().

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

Sets the source to the url, loads the QML component and instantiates it.

Ensure that the URL provided is full and correct, in particular, use QUrl::fromLocalFile() when loading a file from the local filesystem.

Calling this method multiple times with the same URL will result in the QML component being reinstantiated.

See also source().

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

Reimplements: QWidget::showEvent(QShowEvent *event).

QUrl QQuickWidget::source() const

Returns the source URL, if set.

See also setSource().

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

This signal is emitted when the component's current status changes.

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

Reimplements: QWidget::wheelEvent(QWheelEvent *event).