En esta página

Qt Quick Ejemplos: integración en widgets

Muestra cómo integrar un QQuickWindow en una interfaz de usuario de QWidget mediante QWidget::createWindowContainer().

Ventana de widget con campos QLineEdit y contenido QML incrustado que muestra dos instancias de TextField

Este ejemplo muestra uno de los métodos para añadir contenido de Qt Quick a una aplicación basada en QWidget. QQuickView y su clase padre, QQuickWindow, derivan de QWindow. Esto significa que pueden utilizarse con QWidget::createWindowContainer(), al igual que cualquier otro QWindow.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Al incrustar la ventana internamente, se crea un widget hijo nativo dentro de la jerarquía de widgets, y la ventana (el QQuickView del ejemplo) cambia de padre. El widget contenedor se encarga de reposicionar la ventana hija para que parezca formar parte de la interfaz de usuario, aunque en realidad se trate de una ventana nativa independiente que se dibuja de forma independiente de su padre, la ventana de nivel superior basada en ` QWidget`.

MainWindow::MainWindow()
    : m_quickView(new QQuickView)
{
    QWidget *centralWidget = new QWidget(this);
    QVBoxLayout *layout = new QVBoxLayout(centralWidget);

    m_quickView->setResizeMode(QQuickView::SizeRootObjectToView);
    connect(m_quickView, &QQuickView::statusChanged,
            this, &MainWindow::quickViewStatusChanged);
    connect(m_quickView, &QQuickWindow::sceneGraphError,
            this, &MainWindow::sceneGraphError);
    m_quickView->loadFromModule("embeddedinwidgets", "Main");

    QWidget *container = QWidget::createWindowContainer(m_quickView);
    container->setMinimumSize(m_quickView->size());
    container->setFocusPolicy(Qt::TabFocus);

    layout->addWidget(new QLineEdit(QStringLiteral("A QLineEdit")));
    layout->addWidget(container);
    layout->addWidget(new QLineEdit(QStringLiteral("A QLineEdit")));
    setCentralWidget(centralWidget);

    QMenu *fileMenu = menuBar()->addMenu(tr("File"));
    fileMenu->addAction(tr("Quit"), qApp, &QCoreApplication::quit);
}

El paso clave durante la inicialización es la creación de un « container », un « QWidget » que envuelve y aloja el « QQuickView ». A continuación, este widget puede añadirse a un diseño como cualquier otro « QWidget ».

Nota: El uso de la incrustación de ventanas nativas es solo un enfoque posible para combinar las interfaces de usuario de QWidget y Qt Quick. El otro enfoque, más utilizado para esto, es QQuickWidget. Consulte el ejemplo de widgetsQt Quick para ver un ejemplo de uso de QQuickWidget. Existen diferencias significativas a nivel interno en lo que respecta a la representación y la gestión de eventos. QQuickWidget no utiliza ventanas nativas en absoluto y redirige la representación de Qt Quick a una textura que, a continuación, se compone con el resto del contenido de QWidget a través de una API de gráficos 3D como OpenGL o Vulkan. Esto aporta mayor flexibilidad, a costa del rendimiento. También funciona en plataformas en las que no existe un sistema de ventanas propiamente dicho ni el concepto de ventanas nativas. Por su parte, el enfoque de incrustación de ventanas que muestra este ejemplo puede ofrecer un mayor rendimiento, pero resulta más adecuado para interfaces de usuario en las que el contenido de Qt Quick ocupa un área rectangular fija y no se redimensiona, apila ni recorta posteriormente.

Proyecto de ejemplo en code.qt.io

Véase también QWidget::createWindowContainer().

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