En esta página

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().

QNativeInterface::QCocoaGLContext

Interfaz nativa para un NSOpenGLContext en macOS

QNativeInterface::QEGLContext

Interfaz nativa para un contexto EGL

QNativeInterface::QGLXContext

Interfaz nativa para un contexto GLX

QNativeInterface::QWGLContext

Interfaz nativa para un contexto WGL en Windows

QOffscreenSurface

Se accede a través de ` QOffscreenSurface::nativeInterface()`.

QNativeInterface::QAndroidOffscreenSurface

Interfaz nativa para una superficie fuera de pantalla en Android

QSGTexture

Se accede a ella mediante ` QSGTexture::nativeInterface()`.

QNativeInterface::QSGD3D11Texture

Proporciona acceso a los objetos de textura de Direct3D 11 y permite su adopción

QNativeInterface::QSGD3D12Texture

Proporciona acceso a objetos de textura de Direct3D 12 y permite su adopción

QNativeInterface::QSGMetalTexture

Proporciona acceso a objetos de textura de Metal y permite su adopción

QNativeInterface::QSGOpenGLTexture

Proporciona acceso a los objetos de textura de OpenGL y permite su adopción

QNativeInterface::QSGVulkanTexture

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.