QQuickWidget Class

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

Documentación de la función miembro

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

Construye un QQuickWidget con un motor QML por defecto como hijo de parent.

El valor por defecto de parent es nullptr.

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

Construye un QQuickWidget con el QML engine dado como hijo de parent.

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

Construye un QQuickWidget con un motor QML por defecto y el QML source dado como hijo de parent.

El valor por defecto de parent es nullptr.

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

Construye un QQuickWidget con el elemento especificado por uri y typeName y el padre parent. El valor por defecto de parent es nullptr.

Esta función fue introducida en Qt 6.9.

Ver también loadFromModule.

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

Destruye el QQuickWidget.

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

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

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

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

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

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

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

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

QQmlEngine *QQuickWidget::engine() const

Devuelve un puntero a QQmlEngine utilizado para instanciar componentes QML.

QList<QQmlError> QQuickWidget::errors() const

Devuelve la lista de errores que se produjeron durante la última operación de compilación o creación. Cuando el estado no es Error, se devuelve una lista vacía.

Véase también status.

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

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

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

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

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

Reimplementa: QWidget::focusNextPrevChild(bool next).

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

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

QSurfaceFormat QQuickWidget::format() const

Devuelve el formato actual de la superficie.

Si el widget aún no se ha mostrado, se devuelve el formato solicitado.

Véase también setFormat().

QImage QQuickWidget::grabFramebuffer() const

Renderiza un fotograma y lo vuelve a leer en una imagen.

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

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

QSize QQuickWidget::initialSize() const

Devuelve el tamaño inicial del objeto raíz.

Si resizeMode es SizeRootObjectToView, el objeto raíz se redimensionará al tamaño de la vista. Esta función devuelve el tamaño del objeto raíz antes de ser redimensionado.

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

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

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

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

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

Carga el componente QML identificado por uri y typeName. Si el componente está respaldado por un archivo QML, source se configurará en consecuencia. Para los tipos definidos en C++, source estará vacío.

Si se ha definido source antes de llamar a este método, se borrará.

Si se llama a este método varias veces con los mismos uri y typeName, se reiniciará el componente QML.

Esta función se introdujo en Qt 6.9.

Véase también setSource, QQmlComponent::loadFromModule, y QQmlApplicationEngine::loadFromModule.

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

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

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

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

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

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

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

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

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

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

QQuickWindow *QQuickWidget::quickWindow() const

Devuelve el QQuickWindow fuera de pantalla que es utilizado por este widget para controlar el renderizado de Qt Quick. Esto es útil si quieres usar QQuickWindow APIs que no están actualmente expuestas por QQuickWidget, por ejemplo conectarse a la señal QQuickWindow::beforeRendering() para dibujar contenido OpenGL nativo debajo de Qt Quick's own rendering.

QQmlContext *QQuickWidget::rootContext() const

Esta función devuelve la raíz de la jerarquía de contextos. Cada componente QML se instancia en un QQmlContext. Los QQmlContext's son esenciales para pasar datos a los componentes QML. En QML, los contextos se organizan jerárquicamente y esta jerarquía es gestionada por QQmlEngine.

QQuickItem *QQuickWidget::rootObject() const

Devuelve la raíz de la vista item. Puede ser nullptr cuando no se ha llamado a setSource(), si se ha llamado con un código roto QtQuick o si el elemento raíz no está definido de otro modo.

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

Esta señal se emite cuando se produce un error durante la inicialización del gráfico de escena.

Las aplicaciones deben conectarse a esta señal si desean gestionar errores, como fallos en la creación de contextos OpenGL, de forma personalizada. Cuando no hay ninguna ranura conectada a la señal, el comportamiento será diferente: Quick imprimirá el mensaje message, o mostrará un cuadro de mensaje, y terminará la aplicación.

Esta señal será emitida desde el hilo GUI.

Véase también QQuickWindow::sceneGraphError().

void QQuickWidget::setClearColor(const QColor &color)

Establece el color transparente color. Por defecto es un color opaco.

Para obtener un color semitransparente QQuickWidget, llame a esta función con color establecido en Qt::transparent, establezca el atributo widget Qt::WA_TranslucentBackground en la ventana de nivel superior y solicite un canal alfa a través de setFormat().

Véase también QQuickWindow::setColor().

void QQuickWidget::setFormat(const QSurfaceFormat &format)

Establece la superficie format para el contexto y la superficie fuera de pantalla utilizados por este widget.

Llama a esta función cuando es necesario solicitar un contexto para una versión o perfil OpenGL determinado. Los tamaños de los buffers de profundidad, stencil y alpha se calculan automáticamente y no es necesario solicitarlos explícitamente.

Véase también QWindow::setFormat(), QWindow::format(), y format().

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

Establece las propiedades iniciales initialProperties con las que se inicializa el componente QML tras llamar a QQuickWidget::setSource().

Esta función se introdujo en Qt 6.9.

Véase también QQmlComponent::createWithInitialProperties().

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

Establece la fuente en url, carga el componente QML y lo instantiza.

Asegúrese de que la URL proporcionada está completa y es correcta, en particular, utilice QUrl::fromLocalFile() cuando cargue un archivo desde el sistema de archivos local.

Si se llama a este método varias veces con la misma URL, se volverá a instanciar el componente QML.

Véase también source().

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

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

QUrl QQuickWidget::source() const

Devuelve la URL de origen, si se ha establecido.

Véase también setSource().

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

Esta señal se emite cuando cambia la dirección status actual del componente.

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

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