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.

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.
- Widgets de ventana y de diálogo
- Ventana principal de la aplicación
- Ventanas de diálogo
- Foco del teclado en los widgets
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.
|
|
|
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.
|
|
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.

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.

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 += widgetsConsideraciones 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:
- QHeaderView::restoreState() deserializa un blob de estado binario versionado.
- QFileDialog::restoreState() Del mismo modo, deserializa un blob de estado binario que incrusta un blob de estado de « QHeaderView ».
- QMainWindow::restoreState() deserializa un blob de estado binario que describe un diseño de barra de herramientas y widgets acoplables anidados de forma recursiva.
- QSplitter::restoreState() deserializa un blob de estado binario que describe los tamaños y la orientación de los divisores.
- Las hojas de estilo de Qt pueden hacer referencia y cargar archivos locales arbitrarios mediante la función `
url()`.
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
- Tutorial de widgets
- Introducción a la programación con Qt Widgets
- Qt Creator: Tutorial: Aplicación « Qt Widgets »
- Qt Extension for Visual Studio Code: Tutorial: Aplicación « Qt Widgets »
- Tutorial sobre Modelo/Vista
- Enfoques de diseño para Qt Widgets
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.




