En esta página

Qt Widgets

El Qt Widgets Module ofrece un conjunto de elementos de interfaz de usuario para crear interfaces de usuario clásicas al estilo de los ordenadores de sobremesa. Consulta la descripción general de las interfaces de usuario para obtener más información sobre el uso de los widgets.

Widgets

Los widgets son los elementos principales para crear interfaces de usuario en Qt. Los widgets pueden mostrar datos e información de estado, recibir entradas del usuario y servir de contenedor para otros widgets que deban agruparse. Un widget que no está incrustado en un widget padre se denomina ventana.

Widget principal que contiene varios widgets secundarios

La clase ` QWidget ` proporciona la capacidad básica para mostrar contenido en pantalla y gestionar eventos de entrada del usuario. Todos los elementos de interfaz de usuario que proporciona Qt son subclases de ` QWidget ` o se utilizan en combinación con una subclase de ` QWidget `. Para crear widgets personalizados, crea una subclase de ` QWidget ` o de una subclase adecuada y reimplementa los controladores de eventos virtuales.

Estilos

Los estilos se encargan del dibujo en nombre de los widgets y encapsulan la apariencia de una interfaz gráfica de usuario (GUI). Los widgets integrados de Qt utilizan la clase ` QStyle ` para realizar casi todo su dibujo, lo que garantiza que tengan exactamente el mismo aspecto que los widgets nativos equivalentes.

Widgets de pestañas al estilo de Windows

Widgets de pestañas al estilo del escritorio de Fusion

Widgets de pestañas al estilo de macOS

Las hojas de estilo de Qt personalizan la apariencia de los widgets mediante reglas similares a las de CSS. En «Enfoques de estilo para Qt Widgets » se explica cuándo utilizar un estilo, StyleKit o una hoja de estilo.

Diseños

Los diseños son una forma elegante y flexible de organizar automáticamente los widgets hijos dentro de su contenedor. Cada widget comunica sus requisitos de tamaño al diseño a través de las propiedades ` sizeHint ` y ` sizePolicy `, y el diseño distribuye el espacio disponible en consecuencia.

Distribución para 5 niños

Distribución para 6 niños

Qt Widgets Designer es una potente herramienta para crear y organizar widgets de forma interactiva en diseños.

Clases de modelo/vista

La arquitectura modelo/vista proporciona clases que gestionan la forma en que se presentan los datos al usuario. Las aplicaciones basadas en datos que utilizan listas y tablas están estructuradas para separar los datos y la vista mediante modelos, vistas y delegados.

Directorio de archivos con vista en árbol

Vista gráfica

El marco de trabajo de vista gráfica sirve para gestionar e interactuar con un gran número de elementos gráficos 2D personalizados, así como con un widget de vista para visualizar dichos elementos, con soporte para el zoom y la rotación.

Diversas formas y elementos gráficos en una cuadrícula

Uso del módulo

Para utilizar la API de C++ de un módulo de Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación cuentan con soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para su compilación con qmake, añada el módulo como valor de la variable « QT » en el archivo .pro del proyecto:

QT += widgets

Consideraciones de seguridad

Varias clases de Qt Widgets deserializan o analizan datos que una aplicación puede proporcionar desde cualquier fuente, y Qt no puede verificar su procedencia. Presta especial atención a lo siguiente:

Solo se deben pasar a dichas API datos que la propia aplicación haya generado y almacenado previamente (normalmente mediante ` QSettings`), o que, de otro modo, estén totalmente bajo el control de la aplicación.

Artículos y guías

Ejemplos

Referencia de la API

Evolución del módulo

La sección«Cambios en Qt Widgets » enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.

Licencias

El módulo « Qt Widgets » está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre: la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.

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