En esta página

QQuickView Class

La clase QQuickView proporciona una ventana para mostrar una interfaz de usuario de tipo « Qt Quick ». Más información...

Encabezado: #include <QQuickView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Heredado de: QQuickWindow

Tipos públicos

enum ResizeMode { SizeViewToRootObject, SizeRootObjectToView }
enum Status { Null, Ready, Loading, Error }

Propiedades

Funciones públicas

QQuickView(QWindow *parent = nullptr)
QQuickView(QQmlEngine *engine, QWindow *parent)
QQuickView(const QUrl &source, QWindow *parent = nullptr)
(since 6.7) QQuickView(QAnyStringView uri, QAnyStringView typeName, QWindow *parent = nullptr)
virtual ~QQuickView() override
QQmlEngine *engine() const
QList<QQmlError> errors() const
QSize initialSize() const
QQuickView::ResizeMode resizeMode() const
QQmlContext *rootContext() const
QQuickItem *rootObject() const
void setResizeMode(QQuickView::ResizeMode)
QUrl source() const
QQuickView::Status status() const

Ranuras públicas

(since 6.7) void loadFromModule(QAnyStringView uri, QAnyStringView typeName)
void setInitialProperties(const QVariantMap &initialProperties)
void setSource(const QUrl &url)

Señales

void statusChanged(QQuickView::Status status)

Funciones protegidas reimplementadas

virtual void keyPressEvent(QKeyEvent *e) override
virtual void keyReleaseEvent(QKeyEvent *e) override
virtual void mouseMoveEvent(QMouseEvent *e) override
virtual void mousePressEvent(QMouseEvent *e) override
virtual void mouseReleaseEvent(QMouseEvent *e) override

Descripción detallada

Esta es una subclase de conveniencia de ` QQuickWindow ` que carga y muestra automáticamente una escena QML cuando se le proporciona la URL del archivo fuente principal. Como alternativa, puedes instanciar tus propios objetos utilizando ` QQmlComponent ` y colocarlos en un ` QQuickWindow` configurado manualmente.

Uso habitual:

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickView *view = new QQuickView;
    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();
    return app.exec();
}

Para recibir errores relacionados con la carga y la ejecución de QML con QQuickView, puedes conectarte a la señal ` statusChanged()` y supervisar ` QQuickView::Error`. Los errores están disponibles a través de ` QQuickView::errors()`.

QQuickView también gestiona el tamaño de la vista y del objeto raíz. Por defecto, el valor de ` resizeMode ` es ` SizeViewToRootObject`, lo que cargará el componente y ajustará su tamaño al de la vista. Como alternativa, se puede establecer ` resizeMode ` en ` SizeRootObjectToView `, lo que ajustará el tamaño de la vista al del objeto raíz.

Véase también «Exposición de atributos de tipos C++ a QML » y « QQuickWidget ».

Documentación sobre tipos de miembros

enum QQuickView::ResizeMode

Esta enumeración especifica cómo cambiar el tamaño de la vista.

ConstanteValorDescripción
QQuickView::SizeViewToRootObject0La vista cambia de tamaño con el elemento raíz en el QML.
QQuickView::SizeRootObjectToView1La vista ajustará automáticamente el tamaño del elemento raíz al tamaño de la vista.

enum QQuickView::Status

Especifica el estado de carga del QQuickView.

ConstanteValorDescripción
QQuickView::Null0Este QQuickView no tiene ninguna fuente definida.
QQuickView::Ready1Este « QQuickView » ha cargado y creado el componente QML.
QQuickView::Loading2Este QQuickView está cargando datos de red.
QQuickView::Error3Se ha producido uno o más errores. Llama a errors() para obtener una lista de errores.

Documentación de propiedades

resizeMode : ResizeMode

Esta propiedad determina si la vista debe ajustar el tamaño del contenido de la ventana

Si esta propiedad se establece en « SizeViewToRootObject » (valor predeterminado), la vista se redimensiona al tamaño del elemento raíz en el QML.

Si esta propiedad se establece en « SizeRootObjectToView », la vista redimensionará automáticamente el elemento raíz al tamaño de la vista.

Funciones de acceso:

QQuickView::ResizeMode resizeMode() const
void setResizeMode(QQuickView::ResizeMode)

Véase también initialSize().

source : QUrl

Esta propiedad contiene la URL de la fuente del componente QML.

Asegúrate de que la URL proporcionada sea completa y correcta; en concreto, utiliza QUrl::fromLocalFile() al cargar un archivo desde el sistema de archivos local.

Ten en cuenta que al establecer una URL de origen se instanciará el componente QML, incluso si la URL no ha cambiado con respecto al valor actual.

Funciones de acceso:

QUrl source() const
void setSource(const QUrl &url)

[read-only] status : Status

status e actual del componente.

Funciones de acceso:

QQuickView::Status status() const

Señal del notificador:

void statusChanged(QQuickView::Status status)

Documentación de las funciones de miembro

[explicit] QQuickView::QQuickView(QWindow *parent = nullptr)

Crea un QQuickView con el valor dado de ` parent`. El valor por defecto de ` parent ` es 0.

QQuickView::QQuickView(QQmlEngine *engine, QWindow *parent)

Crea un QQuickView con el motor QML « engine » y el « parent » especificados.

Nota: En este caso, el QQuickView no es propietario del objeto ` engine ` indicado; es responsabilidad de quien realiza la llamada destruir el motor. Si el ` engine ` se elimina antes que la vista, ` status()` devolverá ` QQuickView::Error`.

Véase también Status, status() y errors().

[explicit] QQuickView::QQuickView(const QUrl &source, QWindow *parent = nullptr)

Crea un QQuickView con el código QML proporcionado: source y parent. El valor por defecto de parent es nullptr.

[explicit, since 6.7] QQuickView::QQuickView(QAnyStringView uri, QAnyStringView typeName, QWindow *parent = nullptr)

Crea un QQuickView con el elemento especificado por uri y typeName, y con el elemento padre parent. El valor por defecto de parent es nullptr.

Esta función se introdujo en Qt 6.7.

Véase también loadFromModule.

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

Destruye el « QQuickView ».

QQmlEngine *QQuickView::engine() const

Devuelve un puntero al objeto ` QQmlEngine ` utilizado para instanciar componentes QML.

QList<QQmlError> QQuickView::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.

QSize QQuickView::initialSize() const

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

Si ` resizeMode ` es `QQuickItem::SizeRootObjectToView`, el objeto raíz se redimensionará al tamaño de la vista. `initialSize` contiene el tamaño del objeto raíz antes de que se redimensionara.

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

Reimplementa: QQuickWindow::keyPressEvent(QKeyEvent *e).

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

Reimplementa: QQuickWindow::keyReleaseEvent(QKeyEvent *e).

[slot, since 6.7] void QQuickView::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

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

Si se había establecido algún source antes de llamar a este método, se borrará.

Llamar a este método varias veces con el mismo uri y typeName dará lugar a que el componente QML se reinstancie.

Esta función se introdujo en Qt 6.7.

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

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

Reimplementa: ` QQuickWindow::mouseMoveEvent(QMouseEvent *event)`.

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

Reimplementa: ` QQuickWindow::mousePressEvent(QMouseEvent *event)`.

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

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

QQmlContext *QQuickView::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` son esenciales para pasar datos a los componentes QML. En QML, los contextos se organizan jerárquicamente y esta jerarquía la gestiona el ` QQmlEngine`.

QQuickItem *QQuickView::rootObject() const

Devuelve la raíz de la vista item.

[slot] void QQuickView::setInitialProperties(const QVariantMap &initialProperties)

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

    QScopedPointer<QQuickView> view { new QQuickView };
    view->setInitialProperties({"x, 100"}, {"width", 50});
    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();

Nota: Solose puede utilizar esta función para inicializar propiedades de nivel superior.

Nota: Esta función siempre debe llamarse antes de setSource, ya que no tiene ningún efecto una vez que el componente se ha convertido en Ready.

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

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

Establece la fuente en url, carga el componente QML y crea una instancia del mismo.

Asegúrate de que la URL proporcionada esté completa y sea correcta; en concreto, utiliza QUrl::fromLocalFile() al cargar 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.

Nota: Funciónsetter para la propiedad source.

Véase también source().

QUrl QQuickView::source() const

Devuelve la URL de origen, si está definida.

Nota: Funcióngetter para la propiedad «source».

Véase también setSource().

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

Esta señal se emite cuando cambia la propiedad « status » del componente.

Nota: Señalde notificación para la propiedad status.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.