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
- resizeMode : ResizeMode
- source : QUrl
- status : Status
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.
| Constante | Valor | Descripción |
|---|---|---|
QQuickView::SizeViewToRootObject | 0 | La vista cambia de tamaño con el elemento raíz en el QML. |
QQuickView::SizeRootObjectToView | 1 | La 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.
| Constante | Valor | Descripción |
|---|---|---|
QQuickView::Null | 0 | Este QQuickView no tiene ninguna fuente definida. |
QQuickView::Ready | 1 | Este « QQuickView » ha cargado y creado el componente QML. |
QQuickView::Loading | 2 | Este QQuickView está cargando datos de red. |
QQuickView::Error | 3 | Se 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:
[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.