En esta página

Integración de plataformas

La principal ventaja de Qt como kit de herramientas multiplataforma para el desarrollo de aplicaciones es que elimina la necesidad de duplicar el código de la aplicación para cada plataforma de destino.

Aunque Qt resuelve muchas de las tareas típicas de la creación de una aplicación, siempre hay casos excepcionales que Qt no puede cubrir, o en los que tiene más sentido desarrollar una funcionalidad sobre las API específicas de la plataforma o utilizando otro kit de herramientas.

Para dar respuesta a estos casos de uso, sin dejar de permitir que Qt se encargue de la mayor parte de la lógica de la aplicación, Qt ofrece una amplia gama de API de integración con la plataforma, desde simples conversiones de tipos hasta interfaces nativas específicas de cada plataforma.

Conversiones de tipos

Muchos de los tipos de datos básicos de Qt, como QString, QPoint o QImage, permiten realizar conversiones hacia y desde los tipos nativos equivalentes.

Por ejemplo, para obtener el nombre de usuario del usuario actual en plataformas de Apple:

NSProcessInfo *processInfo = NSProcessInfo.processInfo;
QString userName = QString::fromNSString(processInfo.userName)

Para obtener una lista completa de todas las conversiones de tipos, consulta la descripción general de las conversiones de tipos.

Integración 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.

Consulta «Combinación de Qt con otros kits de herramientas de interfaz de usuario » para obtener información detallada sobre cómo Qt da soporte a estos dos casos de uso.

Gestión de eventos

La mayoría de los casos de uso relacionados con el manejo de eventos en Qt quedan suficientemente cubiertos por la entrega de eventos multiplataforma, a través de ` QWindow::event()` y sus funciones relacionadas, o mediante ` QObject::installEventFilter()`.

En los casos en que esto no sea suficiente, Qt proporciona acceso a la entrega de eventos nativos. Se puede instalar un filtro de eventos global que reciba todos los eventos nativos utilizando QCoreApplication::installNativeEventFilter(), mientras que los eventos nativos por ventana se pueden gestionar en QWindow::nativeEvent().

Nota: Interferir en el flujo de eventos nativos puede provocar que Qt entre en un estado inconsistente. Estas API deben utilizarse principalmente para complementar la gestión de eventos existente de Qt, por ejemplo, para eventos que Qt aún no gestiona.

Interfaces nativas

Las funcionalidades específicas de la plataforma que no están cubiertas por las API mencionadas anteriormente se gestionan mediante el mecanismo de interfaces nativas más genérico de Qt. Las interfaces proporcionan acceso a las API nativas o específicas de la plataforma de las clases que extienden.

Las interfaces se encuentran en el espacio de nombres QNativeInterface y abarcan casos de uso como el acceso a identificadores nativos subyacentes, la adopción de identificadores nativos existentes o la provisión de API específicas de la plataforma.

Por ejemplo, para acceder al `NSOpenGLContext` subyacente de un ` QOpenGLContext ` en macOS, a través de la interfaz nativa ` QNativeInterface::QCocoaGLContext `:

using namespace QNativeInterface;
if (auto *cocoaGLContext = glContext->nativeInterface<QCocoaGLContext>())
    [cocoaGLContext->nativeContext() makeCurrentContext];

Para obtener una lista completa de todas las interfaces nativas, consulta la descripción general de las interfaces nativas.

Advertencia: Nohay garantías de compatibilidad, ni a nivel de código fuente ni de binarios, para las API de las interfaces nativas, lo que significa que solo se garantiza que una aplicación que utilice estas interfaces funcione con la versión de Qt con la que se desarrolló.

Compatibilidad con plataformas

Además de las API para desarrolladores de aplicaciones, Qt también interactúa con la plataforma al proporcionar las implementaciones subyacentes de los componentes básicos multiplataforma de Qt.

Algunos ejemplos son las abstracciones del distribuidor de eventos en Qt Core y las abstracciones de hardware de renderizado en RHI.

La principal capa de abstracción en este caso es la Abstracción de Plataforma de Qt(Qt Platform Abstraction, o QPA, por sus siglas en inglés), que se encarga de la integración con el sistema de ventanas y los casos de uso relacionados.

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