Clases de widgets

Las siguientes secciones listan las clases de widgets. Consulta la Galería de Widgets Qt para ver algunos ejemplos.

Estos widgets básicos (controles), por ejemplo botones, comboboxes y barras de desplazamiento, están diseñados para su uso directo.

QCheckBox	Casilla de verificación con etiqueta de texto
QComboBox	Combina un botón con una lista desplegable
QCommandLinkButton	Botón de enlace de comandos estilo Vista
QDateEdit	Widget para editar fechas basado en el widget QDateTimeEdit
QDateTimeEdit	Widget para editar fechas y horas
QDial	Control de rango redondeado (como un velocímetro o potenciómetro)
QDoubleSpinBox	Widget de caja giratoria que toma dobles
QFocusFrame	Marco de enfoque que puede estar fuera del área normal pintable de un widget
QFontComboBox	Combobox que permite al usuario seleccionar una familia de fuentes
QLCDNumber	Muestra un número con dígitos tipo LCD
QLabel	Visualización de texto o imágenes
QLineEdit	Editor de texto de una línea
QMenu	Widget de menú para barras de menú, menús contextuales y otros menús emergentes
QProgressBar	Barra de progreso horizontal o vertical
QPushButton	Botón de comando
QRadioButton	Botón de radio con etiqueta de texto
QScrollArea	Vista de desplazamiento sobre otro widget
QScrollBar	Barra de desplazamiento vertical u horizontal
QSizeGrip	Asa de cambio de tamaño para cambiar el tamaño de las ventanas de nivel superior
QSlider	Deslizador vertical u horizontal
QSpinBox	Widget de caja giratoria
QTabBar	Barra de pestañas, por ejemplo, para diálogos con pestañas
QTabWidget	Pila de widgets con pestañas
QTimeEdit	Widget para editar horas basado en el widget QDateTimeEdit
QToolBox	Columna de elementos de widgets con pestañas
QToolButton	Botón de acceso rápido a comandos u opciones, normalmente utilizado dentro de una QToolBar
QWidget	La clase base de todos los objetos de interfaz de usuario

Los widgets GUI avanzados, por ejemplo los widgets de pestañas y las barras de progreso, proporcionan controles de interfaz de usuario más complejos.

Widget de directorio que muestra el contenido mediante una vista de árbol

Widget de calendario que muestra el mes, el año y el día seleccionado

Pila de deshacer mostrando la lista de comandos

QCalendarWidget	Widget de calendario basado en el mes que permite al usuario seleccionar una fecha
QColumnView	Implementación modelo/vista de una vista de columna
QDataWidgetMapper	Asignación entre una sección de un modelo de datos y los widgets
QListView	Vista de lista o icono en un modelo
QTableView	Implementación de modelo/vista por defecto de una vista de tabla
QTreeView	Implementación por defecto de un modelo/vista de árbol
QUndoView	Muestra el contenido de un QUndoStack

Las clases abstractas de widgets son clases base. No se pueden utilizar como clases independientes, pero proporcionan funcionalidad cuando se subclasifican.

QAbstractButton	La clase base abstracta de los widgets de botón, que proporciona funcionalidad común a los botones
QAbstractScrollArea	Área de desplazamiento con barras de desplazamiento a petición
QAbstractSlider	Valor entero dentro de un rango
QAbstractSpinBox	Spinbox y una línea de edición para mostrar valores
QDialog	La clase base de las ventanas de diálogo
QFrame	La clase base de los widgets que pueden tener un marco

Clases como divisores, barras de pestañas, grupos de botones, etc se utilizan para organizar y agrupar primitivas GUI en aplicaciones y diálogos más complejos.

QButtonGroup	Contenedor para organizar grupos de widgets de botones
QGroupBox	Marco de caja de grupo con un título
QSplitter	Implementa un widget divisor
QSplitterHandle	Maneja la funcionalidad del divisor
QStackedWidget	Pila de widgets en la que sólo es visible uno a la vez
QTabWidget	Pila de widgets con pestañas

Clases de vista gráfica

QAbstractGraphicsShapeItem	Base común para todos los elementos de ruta
QGraphicsAnchor	Representa un ancla entre dos elementos en un QGraphicsAnchorLayout
QGraphicsAnchorLayout	Diseño donde uno puede anclar widgets juntos en Vista Gráfica
QGraphicsEffect	La clase base para todos los efectos gráficos
QGraphicsEllipseItem	Elemento elipse que se puede añadir a una QGraphicsScene
QGraphicsGridLayout	Disposición de rejilla para gestionar widgets en la Vista Gráfica
QGraphicsItem	La clase base para todos los elementos gráficos en una QGraphicsScene
QGraphicsItemGroup	Contenedor que trata un grupo de elementos como un único elemento
QGraphicsLayout	La clase base para todos los diseños en la Vista Gráfica
QGraphicsLayoutItem	Puede ser heredada para permitir que tus ítems personalizados sean manejados por layouts
QGraphicsLineItem	Elemento de línea que se puede añadir a un QGraphicsScene
QGraphicsLinearLayout	Disposición horizontal o vertical para gestionar widgets en la Vista Gráfica
QGraphicsObject	Clase base para todos los ítems gráficos que requieren señales, ranuras y propiedades
QGraphicsPathItem	Elemento Path que puedes añadir a un QGraphicsScene
QGraphicsPixmapItem	Pixmap elemento que se puede añadir a un QGraphicsScene
QGraphicsPolygonItem	Elemento Polígono que puedes añadir a un QGraphicsScene
QGraphicsProxyWidget	Capa proxy para incrustar un QWidget en un QGraphicsScene
QGraphicsRectItem	Elemento rectángulo que puede añadirse a un QGraphicsScene
QGraphicsScene	Superficie para gestionar un gran número de elementos gráficos 2D
QGraphicsSceneContextMenuEvent	Eventos de menú contextual en el marco de la vista gráfica
QGraphicsSceneDragDropEvent	Eventos de arrastrar y soltar en el marco de la vista de gráficos
QGraphicsSceneEvent	Clase base para todos los eventos relacionados con la vista de gráficos
QGraphicsSceneHelpEvent	Eventos cuando se solicita un tooltip
QGraphicsSceneHoverEvent	Eventos Hover en el marco de la vista de gráficos
QGraphicsSceneMouseEvent	Eventos de ratón en el marco de la vista gráfica
QGraphicsSceneMoveEvent	Eventos de movimiento de widgets en el marco de la vista gráfica
QGraphicsSceneResizeEvent	Eventos de cambio de tamaño del widget en el marco de la vista gráfica
QGraphicsSceneWheelEvent	Eventos de rueda en el marco de la vista gráfica
QGraphicsSimpleTextItem	Elemento de texto simple que puede añadirse a una QGraphicsScene
QGraphicsSvgItem	QGraphicsItem que puede utilizarse para representar el contenido de archivos SVG
QGraphicsTextItem	Elemento de texto que se puede añadir a un QGraphicsScene para mostrar texto formateado
QGraphicsTransform	Clase base abstracta para crear transformaciones avanzadas en QGraphicsItems
QGraphicsView	Widget para mostrar el contenido de un QGraphicsScene
QGraphicsWidget	Clase base para todos los widgets de una QGraphicsScene
QStyleOptionGraphicsItem	Se utiliza para describir los parámetros necesarios para dibujar un QGraphicsItem

Clases Modelo/Vista

QAbstractItemDelegate	Utilizadas para mostrar y editar elementos de datos de un modelo
QAbstractItemModel	La interfaz abstracta para las clases de modelo de elementos
QAbstractItemView	Funcionalidad básica de las clases de vista de elementos
QAbstractListModel	Modelo abstracto que puede subclasificarse para crear modelos de listas unidimensionales
QAbstractProxyModel	Clase base para modelos de elementos proxy que pueden realizar tareas de ordenación, filtrado u otras tareas de procesamiento de datos
QAbstractTableModel	Modelo abstracto que puede subclasificarse para crear modelos de tabla
QColumnView	Implementación modelo/vista de una vista de columna
QConcatenateTablesProxyModel	Proxy de múltiples modelos de origen, concatenando sus filas
QDataWidgetMapper	Mapeo entre una sección de un modelo de datos y los widgets
QFileSystemModel	Modelo de datos para el sistema de archivos local
QHeaderView	Fila de cabecera o columna de cabecera para vistas de elementos
QIdentityProxyModel	Proxy de su modelo de origen sin modificar
QItemDelegate	Facilidades de visualización y edición de elementos de datos de un modelo
QItemEditorCreator	Permite crear bases creadoras de editores de ítems sin subclase QItemEditorCreatorBase
QItemEditorCreatorBase	Clase base abstracta que debe subclasificarse al implementar nuevos creadores de editores de elementos
QItemEditorFactory	Widgets para editar datos de elementos en vistas y delegados
QItemSelection	Gestiona la información sobre los elementos seleccionados en un modelo
QItemSelectionModel	Realiza un seguimiento de los elementos seleccionados en una vista
QItemSelectionRange	Gestiona información sobre un rango de elementos seleccionados en un modelo
QListView	Vista de lista o icono en un modelo
QListWidget	Widget de lista basado en elementos
QListWidgetItem	Elemento para utilizar con la clase de vista de elementos QListWidget
QModelIndex	Se utiliza para localizar datos en un modelo de datos
QModelRoleData	Contiene un rol y los datos asociados a ese rol
QModelRoleDataSpan	Se extiende sobre objetos QModelRoleData
QPersistentModelIndex	Utilizado para localizar datos en un modelo de datos
QRangeModel	Implementa QAbstractItemModel para cualquier rango C++
QRangeModel::ItemAccess	La plantilla proporciona un punto de personalización para controlar cómo QRangeModel accede a los datos de rol de elementos individuales
QRangeModel::RowOptions	La plantilla proporciona un punto de personalización para controlar cómo QRangeModel representa los tipos utilizados como filas
QRangeModelAdapter	Acceso compatible con QAbstractItemModel a cualquier rango C++
QSortFilterProxyModel	Soporte para ordenar y filtrar datos pasados entre otro modelo y una vista
QStandardItem	Elemento para utilizar con la clase QStandardItemModel
QStandardItemEditorCreator	Posibilidad de registrar widgets sin tener que subclasificar QItemEditorCreatorBase
QStandardItemModel	Modelo genérico para almacenar datos personalizados
QStringListModel	Modelo que suministra cadenas a las vistas
QStyledItemDelegate	Facilidades de visualización y edición de elementos de datos de un modelo
QTableView	Implementación modelo/vista por defecto de una vista de tabla
QTableWidget	Vista de tabla basada en ítems con un modelo por defecto
QTableWidgetItem	Elemento para utilizar con la clase QTableWidget
QTableWidgetSelectionRange	Manera de interactuar con la selección en un modelo sin utilizar índices de modelo y un modelo de selección
QTreeView	Implementación modelo/vista por defecto de una vista de árbol
QTreeWidget	Vista de árbol que utiliza un modelo de árbol predefinido
QTreeWidgetItem	Elemento para utilizar con la clase de conveniencia QTreeWidget
QTreeWidgetItemIterator	Manera de iterar sobre los ítems en una instancia QTreeWidget

QDockWidget	Widget que puede ser anclado dentro de un QMainWindow o flotado como una ventana de nivel superior en el escritorio
QMainWindow	Ventana principal de la aplicación
QMdiArea	Área en la que se muestran las ventanas MDI
QMdiSubWindow	Clase Subwindow para QMdiArea
QMenu	Widget de menú para barras de menú, menús contextuales y otros menús emergentes
QMenuBar	Barra de menús horizontal
QSizeGrip	Asa de cambio de tamaño para cambiar el tamaño de las ventanas de nivel superior
QStatusBar	Barra horizontal adecuada para presentar información de estado
QToolBar	Panel móvil que contiene un conjunto de controles
QWidgetAction	Amplía QAction mediante una interfaz para insertar widgets personalizados en contenedores basados en acciones, como barras de herramientas

Clases utilizadas para personalizar la apariencia y el estilo de la interfaz de usuario.

QColor	Colores basados en valores RGB, HSV o CMYK
QColorSpace	Abstracción del espacio de color
QColorTransform	Transformación entre espacios de color
QCommonStyle	Encapsula el aspecto común de una interfaz gráfica de usuario
QCursor	Cursor del ratón con una forma arbitraria
QFont	Especifica una consulta para una fuente utilizada para dibujar texto
QFontDatabase	Información sobre los tipos de letra disponibles en el sistema de ventanas subyacente.
QFontInfo	Información general sobre los tipos de letra
QGraphicsAnchor	Representa un ancla entre dos elementos en un QGraphicsAnchorLayout
QGraphicsAnchorLayout	Disposición donde se pueden anclar widgets en una Vista Gráfica
QPalette	Contiene grupos de colores para cada estado de widget
QStyle	Clase base abstracta que encapsula la apariencia de una GUI
QStyleFactory	Crea objetos QStyle
QStyleHintReturn	Sugerencias de estilo que devuelven más que tipos de datos básicos
QStyleHintReturnMask	Sugerencias de estilo que devuelven un QRegion
QStyleHintReturnVariant	Sugerencias de estilo que devuelven una QVariant
QStyleOption	Almacena los parámetros utilizados por las funciones QStyle
QStylePainter	Clase de conveniencia para dibujar elementos QStyle dentro de un widget

Clases de diseño

QBoxLayout	Alinea los widgets hijos horizontal o verticalmente
QButtonGroup	Contenedor para organizar grupos de widgets de botones
QFormLayout	Gestiona formas de widgets de entrada y sus etiquetas asociadas
QGraphicsAnchor	Representa un ancla entre dos elementos en un QGraphicsAnchorLayout
QGraphicsAnchorLayout	Disposición donde uno puede anclar widgets juntos en la Vista Gráfica
QGridLayout	Dispone los widgets en una rejilla
QGroupBox	Agrupa el marco de la caja con un título
QHBoxLayout	Alinea los widgets horizontalmente
QLayout	La clase base de los gestores de geometría
QLayoutItem	Elemento abstracto que manipula un QLayout
QSizePolicy	Atributo Layout que describe la política de redimensionamiento horizontal y vertical
QSpacerItem	Espacio en blanco en un layout
QStackedLayout	Pila de widgets donde sólo un widget es visible a la vez
QStackedWidget	Pila de widgets donde sólo un widget es visible a la vez
QVBoxLayout	Alinea los widgets verticalmente
QWidgetItem	Elemento de diseño que representa un widget

Galería de widgets

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

Clases de widgets