En esta página

Qt GUI Descripción general

El módulo Qt GUI proporciona clases para la integración con el sistema de ventanas, la gestión de eventos, la integración con OpenGL y OpenGL ES, gráficos 2D, procesamiento básico de imágenes, fuentes y texto. Estas clases son utilizadas internamente por las tecnologías de interfaz de usuario de Qt, pero también pueden utilizarse directamente, por ejemplo, para escribir aplicaciones que utilicen API gráficas de bajo nivel de OpenGL ES.

Para los desarrolladores de aplicaciones que crean interfaces de usuario, Qt proporciona API de nivel superior, como Qt Quick, que resultan mucho más adecuadas que los componentes de habilitación que se encuentran en el módulo Qt GUI.

Ventanas de aplicación

Las clases más importantes del módulo Qt GUI son QGuiApplication y QWindow. Una aplicación Qt que desee mostrar contenido en pantalla debe utilizar estas clases. QGuiApplication contiene el bucle de eventos principal, donde se procesan y distribuyen todos los eventos procedentes del sistema de ventanas y otras fuentes. También se encarga de la inicialización y la finalización de la aplicación.

La clase ` QWindow ` representa una ventana en el sistema de ventanas subyacente. Proporciona una serie de funciones virtuales para gestionar eventos (QEvent) procedentes del sistema de ventanas, tales como entradas táctiles, exposición, foco, pulsaciones de teclas y cambios de geometría.

Gráficos 2D

El módulo Qt GUI contiene clases para gráficos 2D, imágenes, fuentes y tipografía avanzada.

Una superficie de trabajo ( QWindow ) creada con el tipo de superficie QSurface::RasterSurface puede utilizarse en combinación con QBackingStore y QPainter, la API de gráficos vectoriales 2D altamente optimizada de Qt. QPainter permite dibujar líneas, polígonos, trazados vectoriales, imágenes y texto. Para obtener más información, consulta «Sistema de pintura » y «Ejemplo de ventana rasterizada».

Qt puede cargar y guardar imágenes utilizando las clases QImage y QPixmap. De forma predeterminada, Qt es compatible con los formatos de imagen más comunes, incluidos JPEG y PNG, entre otros. Los usuarios pueden añadir compatibilidad con formatos adicionales a través de la clase QImageIOPlugin. Para obtener más información, consulte «Lectura y escritura de archivos de imagen».

La tipografía en Qt se gestiona mediante ` QTextDocument`, que utiliza la API ` QPainter ` en combinación con las clases de fuentes de Qt, principalmente ` QFont`. Las aplicaciones que prefieran API de más bajo nivel para el manejo de texto y fuentes pueden utilizar clases como ` QRawFont ` y ` QGlyphRun`.

Gráficos RHI

La Interfaz de Hardware de Representación de Qt (RHI) es una abstracción para las API gráficas con aceleración por hardware, como OpenGL, OpenGL ES, Direct3D, Metal y Vulkan.

Como alternativa al uso directo de OpenGL o Vulkan para renderizar en un « QWindow », QRhi y las clases relacionadas proporcionan una API de gráficos 3D y computación portátil y multiplataforma, complementada con un canal de procesamiento para la preparación y transpilación de shaders. De este modo, las aplicaciones pueden evitar depender directamente de una única API 3D que, en algunos casos, es específica de un proveedor o de una plataforma.

A continuación se muestra una lista de las principales clases relacionadas con RHI. Estas se complementan con una serie de clases y estructuras adicionales.

Consulte el ejemplo «RHI Window Example» para ver un ejemplo introductorio sobre cómo crear una aplicación portátil y multiplataforma que realice un renderizado 3D acelerado en un « QWindow » utilizando « QRhi ».

Trabajar directamente con QWindow es la forma más avanzada y, a menudo, la más flexible de realizar el renderizado con la API QRhi. Sin embargo, se trata del enfoque de más bajo nivel y está limitado en el sentido de que las tecnologías de interfaz de usuario de Qt, los widgets y Qt Quick no se utilizan en absoluto. En muchos casos, las aplicaciones preferirán integrar el renderizado basado en QRhi en un widget o en una interfaz de usuario basada en Qt Quick. Las aplicaciones basadas en QWidget pueden optar por incrustar la ventana como un elemento secundario nativo en la jerarquía de widgets mediante QWidget::createWindowContainer(), pero en muchos casos QRhiWidget ofrecerá una forma más cómoda de integrar el renderizado basado en QRhi en la interfaz de usuario de un widget. Qt Quick proporciona su propio conjunto de herramientas para ampliar la escena 2D/3D con renderizado personalizado basado en QRhi.

Nota: La familia de API RHI se ofrece actualmente con una garantía de compatibilidad limitada, a diferencia de las API públicas habituales de Qt. Consulta QRhi para obtener más detalles.

Matemáticas de matrices y vectores en 3D

El módulo « Qt GUI » también contiene algunas clases matemáticas que facilitan las operaciones matemáticas más comunes relacionadas con los gráficos 3D. Entre estas clases se incluyen « QMatrix4x4 », « QVector2D », « QVector3D », « QVector4D » y « QQuaternion ».

Integración con OpenGL y OpenGL ES

QWindow admite el renderizado mediante OpenGL y OpenGL ES, dependiendo de lo que admita la plataforma. El renderizado OpenGL se habilita configurando el tipo de superficie de ` QWindow` como ` QSurface::OpenGLSurface`, seleccionando los atributos de formato con ` QSurfaceFormat` y, a continuación, creando un ` QOpenGLContext ` para gestionar el contexto nativo de OpenGL. Además, Qt cuenta con QOpenGLPaintDevice, que permite el uso del renderizado acelerado por OpenGL QPainter, así como con clases de conveniencia que simplifican la escritura de código OpenGL y ocultan las complejidades del manejo de extensiones y las diferencias entre OpenGL ES 2 y OpenGL de escritorio. Entre las clases de conveniencia se incluye QOpenGLFunctions, que permite a una aplicación utilizar todas las funciones de OpenGL ES 2 en OpenGL de escritorio sin tener que resolver manualmente los punteros de función de OpenGL. Esto permite el desarrollo multiplataforma de aplicaciones destinadas a dispositivos móviles o embebidos, y proporciona clases que envuelven la funcionalidad nativa de OpenGL en una API de Qt más sencilla:

Por último, para ofrecer una mejor compatibilidad con las versiones más recientes (3.0 y superiores) de OpenGL, también se dispone de un mecanismo de envoltura de funciones con control de versiones: La familia de clases QOpenGLFunction_N_N expone todas las funciones de una versión y un perfil determinados de OpenGL, lo que permite desarrollar fácilmente aplicaciones de escritorio que se basan en características modernas de OpenGL exclusivas de escritorio.

Para obtener más información, consulta el ejemplo «OpenGL Window».

Un objeto ` QWindow ` creado con ` QSurface::OpenGLSurface ` puede utilizarse junto con ` QPainter ` y ` QOpenGLPaintDevice ` para obtener gráficos 2D acelerados por hardware mediante OpenGL, a cambio de sacrificar parte de la calidad visual.

Integración con Vulkan

Qt GUI es compatible con la API Vulkan. Las aplicaciones Qt requieren la presencia del SDK de LunarG para Vulkan.

En Windows, el SDK establece la variable de entorno VULKAN_SDK, que será detectada por el script configure.

En Android, se añadieron los encabezados de Vulkan en el nivel de API 24 del NDK.

Las principales clases relevantes para la compatibilidad de bajo nivel con Vulkan son:

Además, QVulkanWindow proporciona una subclase de QWindow que facilita el inicio en la implementación de un renderizado basado en Vulkan dirigido a un QWindow. El uso de esta clase auxiliar es totalmente opcional; las aplicaciones con renderizadores basados en Vulkan más avanzados pueden optar por utilizar directamente un QWindow con el tipo QSurface::VulkanSurface.

Para obtener más información, consulta el ejemplo «Hello Vulkan Widget » y el ejemplo «Hello Vulkan Triangle».

Arrastrar y soltar

Qt GUI incluye compatibilidad con la función de arrastrar y soltar. La descripción general de «Arrastrar y soltar » ofrece 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.