En esta página

Clases de widgets

Las clases de widgets

En las siguientes secciones se enumeran las clases de widgets. Consulta la Galería de widgets de Qt para ver algunos ejemplos.

Clases de widgets básicos

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

Etiqueta

Botón «Cancelar»

Barra de progreso

Cuadro combinado

Casilla de radio

Edición de línea

QCheckBox

Casilla de selección con etiqueta de texto

QComboBox

Combina un botón con una lista desplegable

QCommandLinkButton

Botón de enlace de comando al 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 un potenciómetro)

QDoubleSpinBox

Widget de cuadro giratorio que admite valores de tipo double

QFocusFrame

Marco de enfoque que puede situarse fuera del área pintable normal de un widget

QFontComboBox

Cuadro combinado que permite al usuario seleccionar una familia tipográfica

QLCDNumber

Muestra un número con dígitos similares a los de una pantalla LCD

QLabel

Visualización de texto o imágenes

QLineEdit

Editor de texto de una línea

QMenu

Widget de menú para su uso en 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 opción con etiqueta de texto

QScrollArea

Vista deslizante sobre otro widget

QScrollBar

Barra de desplazamiento vertical u horizontal

QSizeGrip

Controlador de redimensionamiento para cambiar el tamaño de ventanas de nivel superior

QSlider

Control deslizante vertical u horizontal

QSpinBox

Widget de cuadro giratorio

QTabBar

Barra de pestañas, p. ej., para su uso en cuadros de diálogo 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, que suele utilizarse dentro de una QToolBar

QWidget

La clase base de todos los objetos de la interfaz de usuario

Clases de widgets avanzadas

Los widgets avanzados de la interfaz gráfica de usuario, como 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 en árbol

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

Pila de deshacer con la lista de comandos

QCalendarWidget

Widget de calendario mensual que permite al usuario seleccionar una fecha

QColumnView

Implementación modelo/vista de una vista de columnas

QDataWidgetMapper

Asignación entre una sección de un modelo de datos y los widgets

QListView

Vista de lista o de iconos sobre un modelo

QTableView

Implementación predeterminada de modelo/vista de una vista de tabla

QTreeView

Implementación predeterminada de modelo/vista de una vista de árbol

QUndoView

Muestra el contenido de un QUndoStack

Clases de widgets abstractas

Las clases de widgets abstractas son clases base. No se pueden utilizar como clases independientes, pero proporcionan funcionalidad cuando se crean subclases a partir de ellas.

QAbstractButton

La clase base abstracta de los widgets de botón, que proporciona la 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

Un cuadro giratorio y un campo de edición de línea 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 de widgets organizadores

Las clases como los separadores, las barras de pestañas, los grupos de botones, etc., se utilizan para organizar y agrupar elementos básicos de la interfaz gráfica de usuario en aplicaciones y ventanas de diálogo más complejas.

QButtonGroup

Contenedor para organizar grupos de widgets de botones

QGroupBox

Marco de cuadro de grupo con título

QSplitter

Implementa un widget divisor

QSplitterHandle

Funcionalidad de control para el divisor

QStackedWidget

Pila de widgets en la que solo se ve 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 anclaje entre dos elementos en un QGraphicsAnchorLayout

QGraphicsAnchorLayout

Diseño en el que se pueden anclar widgets entre sí en la vista gráfica

QGraphicsEffect

La clase base para todos los Graphical Effects

QGraphicsEllipseItem

Elemento elíptico que se puede añadir a un QGraphicsScene

QGraphicsGridLayout

Diseño de cuadrícula para gestionar widgets en la vista gráfica

QGraphicsItem

La clase base para todos los elementos gráficos de un QGraphicsScene

QGraphicsItemGroup

Contenedor que trata un grupo de elementos como un único elemento

QGraphicsLayout

La clase base para todas las distribuciones en Graphics View

QGraphicsLayoutItem

Se puede heredar para permitir que los diseños gestionen tus elementos personalizados

QGraphicsLineItem

Elemento de línea que se puede añadir a un QGraphicsScene

QGraphicsLinearLayout

Diseño horizontal o vertical para gestionar widgets en Graphics View

QGraphicsObject

Clase base para todos los elementos gráficos que requieren señales, ranuras y propiedades

QGraphicsPathItem

Elemento de ruta que se puede añadir a un QGraphicsScene

QGraphicsPixmapItem

Elemento «Pixmap» que se puede añadir a un QGraphicsScene

QGraphicsPolygonItem

Elemento «Polygon» que se puede añadir a un QGraphicsScene

QGraphicsProxyWidget

Capa proxy para incrustar un QWidget en un QGraphicsScene

QGraphicsRectItem

Elemento «Rectangle» que se puede añadir a un QGraphicsScene

QGraphicsScene

Superficie para gestionar un gran número de elementos gráficos 2D

QGraphicsSceneContextMenuEvent

Eventos del menú contextual en el marco de trabajo de la vista gráfica

QGraphicsSceneDragDropEvent

Eventos de arrastrar y soltar en el marco de trabajo de la vista gráfica

QGraphicsSceneEvent

Clase base para todos los eventos relacionados con la vista gráfica

QGraphicsSceneHelpEvent

Eventos cuando se solicita una información sobre el elemento

QGraphicsSceneHoverEvent

Eventos de paso del cursor en el marco de la vista gráfica

QGraphicsSceneMouseEvent

Eventos del ratón en el marco de la vista gráfica

QGraphicsSceneMoveEvent

Eventos relacionados con el desplazamiento de widgets en el marco de la vista gráfica

QGraphicsSceneResizeEvent

Eventos relacionados con el cambio de tamaño de los widgets en el marco de la vista gráfica

QGraphicsSceneWheelEvent

Eventos de rueda en el marco de trabajo de la vista gráfica

QGraphicsSimpleTextItem

Elemento de texto sencillo que se puede añadir a un QGraphicsScene

QGraphicsSvgItem

QGraphicsItem que se puede utilizar 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 sobre QGraphicsItems

QGraphicsView

Widget para mostrar el contenido de un QGraphicsScene

QGraphicsWidget

La clase base para todos los elementos de widget de un QGraphicsScene

QStyleOptionGraphicsItem

Se utiliza para describir los parámetros necesarios para dibujar un QGraphicsItem

Clases de modelo/vista

QAbstractItemDelegate

Se utilizan para mostrar y editar elementos de datos de un modelo

QAbstractItemModel

La interfaz abstracta para las clases de modelo de elementos

QAbstractItemView

La funcionalidad básica para las clases de vista de elementos

QAbstractListModel

Modelo abstracto del que se pueden crear subclases para generar modelos de lista 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 del que se pueden crear subclases para crear modelos de tabla

QColumnView

Implementación de modelo/vista de una vista de columna

QConcatenateTablesProxyModel

Actúa como proxy de varios modelos de origen, concatenando sus filas

QDataWidgetMapper

Asignación entre una sección de un modelo de datos y los widgets

QFileSystemModel

Modelo de datos para el sistema de archivos local

QHeaderView

Fila o columna de encabezado para vistas de elementos

QIdentityProxyModel

Actúa como proxy de su modelo de origen sin modificaciones

QItemDelegate

Funciones de visualización y edición de elementos de datos de un modelo

QItemEditorCreator

Permite crear bases para creadores de editores de elementos sin necesidad de subclasificar 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 la información sobre un rango de elementos seleccionados en un modelo

QListView

Vista de lista o de iconos de 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

Alberga un rol y los datos asociados a dicho rol

QModelRoleDataSpan

Abarca objetos QModelRoleData

QPersistentModelIndex

Se utiliza para localizar datos en un modelo de datos

QRangeModel

Implementa QAbstractItemModel para cualquier rango de C++

QRangeModel::ItemAccess

La plantilla proporciona un punto de personalización para controlar cómo QRangeModel accede a los datos de rol de los 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 de C++

QRangeModelAdapter::ColumnIterator

Proporciona un iterador no constante, al estilo de la STL, sobre las columnas de una fila del modelo

QRangeModelAdapter::ConstColumnIterator

Proporciona un iterador no constante, al estilo de la STL, sobre las columnas de una fila del modelo

QRangeModelAdapter::ConstRowIterator

Proporciona un iterador const al estilo STL sobre las filas de un modelo

QRangeModelAdapter::ConstRowReference

Envoltura de referencia en torno a una fila const de un QRangeModel

QRangeModelAdapter::DataReference

Envoltura de referencia en torno a un elemento de un QRangeModel

QRangeModelAdapter::RowIterator

Proporciona un iterador no constante, al estilo STL, sobre las filas de un modelo

QRangeModelAdapter::RowReference

Envoltura de referencia en torno a una fila de un QRangeModel

QRangeModelAdapter::RowReferenceBase

API común para RowReference y ConstRowReference

QSortFilterProxyModel

Compatibilidad con la ordenación y el filtrado de datos transmitidos entre otro modelo y una vista

QStandardItem

Elemento para su uso con la clase QStandardItemModel

QStandardItemEditorCreator

Posibilidad de registrar widgets sin necesidad de crear una subclase de QItemEditorCreatorBase

QStandardItemModel

Modelo genérico para almacenar datos personalizados

QStringListModel

Modelo que proporciona cadenas de caracteres a las vistas

QStyledItemDelegate

Funciones de visualización y edición de elementos de datos de un modelo

QTableView

Implementación predeterminada de modelo/vista de una vista de tabla

QTableWidget

Vista de tabla basada en elementos con un modelo predeterminado

QTableWidgetItem

Elemento para su uso con la clase QTableWidget

QTableWidgetSelectionRange

Forma de interactuar con la selección en un modelo sin utilizar índices de modelo ni un modelo de selección

QTreeView

Implementación predeterminada de modelo/vista 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

Forma de recorrer los elementos de una instancia de QTreeWidget

QDockWidget

Widget que se puede acoplar dentro de una QMainWindow o mostrar como ventana flotante 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 de subventana para QMdiArea

QMenu

Widget de menú para su uso en barras de menú, menús contextuales y otros menús emergentes

QMenuBar

Barra de menús horizontal

QSizeGrip

Controlador de redimensionamiento para cambiar el tamaño de las ventanas de nivel superior

QStatusBar

Barra horizontal adecuada para mostrar información de estado

QToolBar

Panel móvil que contiene un conjunto de controles

QWidgetAction

Amplía QAction con una interfaz para insertar widgets personalizados en contenedores basados en acciones, como las 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 y la sensación comunes de una interfaz gráfica de usuario

QCursor

Cursor del ratón con una forma arbitraria

QFont

Especifica una consulta sobre la fuente utilizada para dibujar texto

QFontDatabase

Información sobre las fuentes disponibles en el sistema de ventanas subyacente

QFontInfo

Información general sobre las fuentes

QGraphicsAnchor

Representa un anclaje entre dos elementos en un QGraphicsAnchorLayout

QGraphicsAnchorLayout

Diseño en el que se pueden anclar widgets entre sí en Graphics View

QPalette

Contiene grupos de colores para cada estado del widget

QStyle

Clase base abstracta que encapsula el aspecto y el comportamiento de una interfaz gráfica de usuario

QStyleFactory

Crea objetos QStyle

QStyleHintReturn

Sugerencias de estilo que devuelven más que tipos de datos básicos

QStyleHintReturnMask

Sugerencias de estilo que devuelven una QRegion

QStyleHintReturnVariant

Sugerencias de estilo que devuelven un QVariant

QStyleKitStyle

Aplica un estilo de Qt Labs StyleKit a Qt Widgets

QStyleOption

Almacena los parámetros utilizados por las funciones de 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 botón

QFormLayout

Gestiona los formularios de los widgets de entrada y sus etiquetas asociadas

QGraphicsAnchor

Representa un anclaje entre dos elementos en un QGraphicsAnchorLayout

QGraphicsAnchorLayout

Diseño en el que se pueden anclar widgets entre sí en la vista gráfica

QGridLayout

Distribuye los widgets en una cuadrícula

QGroupBox

Marco de cuadro de grupo con 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 de diseño que describe la política de redimensionamiento horizontal y vertical

QSpacerItem

Espacio en blanco en un diseño

QStackedLayout

Pila de widgets en la que solo es visible un widget a la vez

QStackedWidget

Pila de widgets en la que solo es visible un widget a la vez

QVBoxLayout

Alinea los widgets verticalmente

QWidgetItem

Elemento de diseño que representa un widget

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