Combinación de Qt con otros kits de herramientas de interfaz de usuario
Qt ofrece un conjunto completo de componentes y controles de interfaz de usuario multiplataforma que cubren la gran mayoría de las necesidades de desarrollo de aplicaciones. Sin embargo, hay situaciones en las que resulta necesario o beneficioso integrar Qt con otros kits de herramientas de interfaz de usuario.
Un caso es la incorporación de interfaces de usuario de Qt en aplicaciones creadas con otros kits de herramientas, por ejemplo, al implementar complementos para una aplicación existente o al introducir gradualmente Qt en un código base ya existente.
Otro caso es alojar elementos de interfaz de usuario nativos o de terceros en una aplicación Qt, por ejemplo, para acceder a controles especializados que Qt no proporciona.
A continuación, analizaremos diferentes aspectos para resolver estos dos casos de uso.
Ventanas externas
Para integrar Qt con otros kits de herramientas de interfaz de usuario, primero necesitamos una representación compartida de los bloques de construcción primitivos de la interfaz de usuario para esa plataforma. En Qt, esto se representa mediante el tipo ` WId `, un identificador opaco, y cada plataforma tiene su propia definición del tipo nativo al que se asigna.
| Plataforma | Tipo WId |
|---|---|
| macOS | NSView* |
| Windows | HWND |
| X11 | xcb_window_t |
| iOS | UIView* |
| Android | Ver |
| WebAssembly | emscripten::val* |
El siguiente paso consiste en envolver ese identificador nativo en algo con lo que Qt pueda interactuar. Partimos de la abstracción « QWindow » de Qt creando una representación « QWindow » del identificador nativo.
Una ventana creada de esta manera se conoce como «ventana externa» en Qt, ya que representa un control creado por un kit de herramientas de interfaz de usuario externo (a Qt).
Nota: Qt no asume la propiedad (exclusiva) del identificador de la ventana nativa al crear una ventana externa, por lo que la aplicación es responsable de mantener activa la ventana nativa durante toda la vida útil de la ventana externa QWindow.
Ahora podemos integrar nuestra interfaz de usuario de Qt en esta ventana externa, o bien alojar la ventana externa en nuestra interfaz de usuario de Qt.
Incrustación de Qt en otros kits de herramientas de interfaz de usuario
Para integrar interfaces de usuario de Qt en otros kits de herramientas de interfaz de usuario, utilizamos la ventana externa como ventana principal de nuestra interfaz de usuario.
Incrustación Qt Widgets
Para integrar una interfaz de usuario de Qt Widgets, solicitamos al widget su window handle y, a continuación, le asignamos la ventana externa como ventana principal.
QMainWindow *mainWindow = new QMainWindow;
mainWindow->windowHandle()->setParent(foreignWindow);Incrustación Qt Quick
Para integrar una interfaz de usuario de « Qt Quick », podemos asignar directamente la «quick view» a la ventana externa como su ventana principal.
QQuickView *quickView = new QQuickView;
quickView->setParent(foreignWindow);Cuando no hay un identificador de ventana principal
En algunos casos, es posible que no tengamos acceso al identificador de padre nativo y, en su lugar, se nos pida que generemos un identificador nativo que se reasignará fuera de nuestro control.
Dado que una « QWindow » sin padre suele ser una ventana de nivel superior, primero debemos indicar explícitamente a Qt que la ventana va a ser una ventana hija, añadiendo el indicador « Qt::SubWindow ».
quickView->setFlags(quickView->flags() | Qt::SubWindow);A continuación, solicitamos al ` QWidget ` o ` QQuickView ` su ` WId`, mediante
QWindow::winId(), y a continuación devolvemos este identificador nativo para que se le asigne un padre nuevo.
return reinterpret_cast<NSView*>(quickView->winId());Distribución de eventos
Qt depende de poder procesar eventos y temporizadores de forma regular, por lo que, al integrar interfaces de usuario de Qt en otro kit de herramientas de interfaz de usuario, seguimos necesitando un QGuiApplication. Un patrón típico consiste en crear la instancia de la aplicación al construir por primera vez la interfaz de usuario de Qt y, a continuación, eliminarla cuando sabemos que la interfaz de usuario de Qt se ha desmontado, por ejemplo, durante la descarga de un complemento.
Alojamiento de otros kits de interfaz de usuario en Qt
Para alojar otros kits de interfaz de usuario en Qt, envolvemos la ventana externa en un Qt Widget o en un contenedor de ventanas específico de Qt Quick.
Integración en Qt Widgets
Para aplicaciones creadas sobre la pila de interfaz de usuario de Qt Widgets, creamos una representación de QWidget de QWindow, mediante QWidget::createWindowContainer(), que luego puede gestionarse como cualquier otro widget, por ejemplo, en un diseño.
QWidget *hostedWidget = QWidget::createWindowContainer(foreignWindow);
layout->addWidget(hostedWidget);Alojamiento en Qt Quick
Para las aplicaciones creadas con la pila de interfaz de usuario Qt Quick, exponemos la ventana externa al QQmlApplicationEngine y, a continuación, utilizamos el elemento WindowContainer para gestionar dicha ventana.
engine.setInitialProperties({{ "foreignWindow", QVariant::fromValue(foreignWindow) }});ApplicationWindow {
required property QtObject foreignWindow;
WindowContainer {
window: foreignWindow
anchors.centerIn: parent
}
}Consulte el ejemplo de alojamiento de ventanas para obtener información detallada sobre este caso de uso.
Soluciones específicas para cada plataforma
Las primitivas básicas para la incrustación y el alojamiento de ventanas descritas anteriormente deberían cubrir la mayoría de los casos, pero Qt también ofrece soluciones específicas para cada plataforma cuando se necesita una integración aún más profunda.
Active Qt Módulo
La compatibilidad de Qt con ActiveX y COM permite a los desarrolladores de Qt para Windows acceder y utilizar controles ActiveX y objetos COM proporcionados por cualquier servidor ActiveX en sus aplicaciones Qt, así como hacer que sus aplicaciones Qt estén disponibles como servidores COM, con cualquier número de objetos y widgets Qt como objetos COM y controles ActiveX.
Consulte Active Qt para obtener más información.
© 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.