Interfaces nativas
Las interfaces nativas 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 los identificadores nativos subyacentes, la adopción de identificadores nativos existentes o la provisión de API específicas de la plataforma.
Ejemplo de uso
Acceso a los identificadores nativos subyacentes
En situaciones en las que una característica de la plataforma nativa no está expuesta en Qt, puede resultar útil acceder a los identificadores nativos gestionados por Qt y utilizarlos para llamar a las API nativas.
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];Se accede a la interfaz nativa a través del accesor QOpenGLContext::nativeInterface(), que garantiza que la interfaz solicitada esté disponible y, en caso contrario, devuelve nullptr. A continuación, se accede al NSOpenGLContext subyacente a través del accesor nativeContext().
Adopción de identificadores nativos existentes
En algunas situaciones, la plataforma nativa u otro kit de herramientas ha creado un identificador nativo que se desea pasar a Qt, es decir, envolver el identificador existente en lugar de crear uno nuevo.
Por ejemplo, para adoptar un `NSOpenGLContext` existente y utilizarlo para compartir recursos con un contexto creado por Qt:
using namespace QNativeInterface;
QOpenGLContext *adoptedContext = QCocoaGLContext::fromNativeContext(nsOpenGLContext);
anotherContext->setShareContext(adoptedContext);El contexto adoptado se crea mediante una función de fábrica específica de la plataforma en la interfaz nativa QNativeInterface::QCocoaGLContext.
Acceso a las API específicas de la plataforma
En algunos casos, una API es demasiado específica de la plataforma como para incluirla en las clases multiplataforma de Qt, pero sigue siendo útil incluirla. Estas API están disponibles bien de la misma forma que al acceder a los identificadores nativos subyacentes, a través del accesor ` nativeInterface()`, o bien directamente como función estática en la interfaz nativa.
Por ejemplo, para obtener el identificador del módulo OpenGL en Windows:
using namespace QNativeInterface;
HMODULE moduleHandle = QWGLContext::openGLModuleHandle();Compatibilidad de código fuente y binaria
No hay garantías de compatibilidad de código fuente ni binaria para las API de la interfaz nativa, 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ó.
Interfaces disponibles
Para obtener una lista de todas las interfaces disponibles, consulta el espacio de nombres QNativeInterface.
QOpenGLContext
Se accede a través de QOpenGLContext::nativeInterface().
Interfaz nativa para un NSOpenGLContext en macOS | |
Interfaz nativa para un contexto EGL | |
Interfaz nativa para un contexto GLX | |
Interfaz nativa para un contexto WGL en Windows |
QOffscreenSurface
Se accede a través de ` QOffscreenSurface::nativeInterface()`.
Interfaz nativa para una superficie fuera de pantalla en Android |
QSGTexture
Se accede a ella mediante ` QSGTexture::nativeInterface()`.
Proporciona acceso a los objetos de textura de Direct3D 11 y permite su adopción | |
Proporciona acceso a objetos de textura de Direct3D 12 y permite su adopción | |
Proporciona acceso a objetos de textura de Metal y permite su adopción | |
Proporciona acceso a los objetos de textura de OpenGL y permite su adopción | |
Proporciona acceso a los objetos de imagen de Vulkan y permite su adopció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.