QQuickWidget Class

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

Member Function Documentation

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

Constructs a QQuickWidget with the given QML source and parent. The default value of parent is 0.

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

Constructs a QQuickWidget with the given QML engine and parent.

Note: In this case, the QQuickWidget does not own the given engine object; it is the caller's responsibility to destroy the engine. If the engine is deleted before the view, status() will return QQuickWidget::Error.

See also Status, status(), and errors().

QQuickWidget::QQuickWidget(QWidget *parent = nullptr)

Constructs a QQuickWidget with the given parent. The default value of parent is 0.

[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().

[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.

Note: Setter function for property source.

See also source().

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

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

Note: Notifier signal for property status.

[override virtual] 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).

[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.

This function was introduced in Qt 5.5.

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.

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().

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

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

QUrl QQuickWidget::source() const

Returns the source URL, if set.

Note: Getter function for property source.

See also setSource().

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

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