QTableWidgetItem Class
La clase `QTableWidgetItem` proporciona un elemento para su uso con la clase ` QTableWidget `. Más información...
| Encabezado: | #include <QTableWidgetItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
Tipos públicos
| enum | ItemType { Type, UserType } |
Funciones públicas
| QTableWidgetItem(int type = Type) | |
| QTableWidgetItem(const QString &text, int type = Type) | |
| QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type) | |
| QTableWidgetItem(const QTableWidgetItem &other) | |
| virtual | ~QTableWidgetItem() |
| QBrush | background() const |
| Qt::CheckState | checkState() const |
| virtual QTableWidgetItem * | clone() const |
| int | column() const |
| virtual QVariant | data(int role) const |
| Qt::ItemFlags | flags() const |
| QFont | font() const |
| QBrush | foreground() const |
| QIcon | icon() const |
| bool | isSelected() const |
| virtual void | read(QDataStream &in) |
| int | row() const |
| void | setBackground(const QBrush &brush) |
| void | setCheckState(Qt::CheckState state) |
| virtual void | setData(int role, const QVariant &value) |
| void | setFlags(Qt::ItemFlags flags) |
| void | setFont(const QFont &font) |
| void | setForeground(const QBrush &brush) |
| void | setIcon(const QIcon &icon) |
| void | setSelected(bool select) |
| void | setSizeHint(const QSize &size) |
| void | setStatusTip(const QString &statusTip) |
| void | setText(const QString &text) |
(since 6.4) void | setTextAlignment(Qt::Alignment alignment) |
| void | setToolTip(const QString &toolTip) |
| void | setWhatsThis(const QString &whatsThis) |
| QSize | sizeHint() const |
| QString | statusTip() const |
| QTableWidget * | tableWidget() const |
| QString | text() const |
| int | textAlignment() const |
| QString | toolTip() const |
| int | type() const |
| QString | whatsThis() const |
| virtual void | write(QDataStream &out) const |
| virtual bool | operator<(const QTableWidgetItem &other) const |
| QTableWidgetItem & | operator=(const QTableWidgetItem &other) |
Elementos no miembros relacionados
| QDataStream & | operator<<(QDataStream &out, const QTableWidgetItem &item) |
| QDataStream & | operator>>(QDataStream &in, QTableWidgetItem &item) |
Descripción detallada
Los elementos de tabla se utilizan para almacenar información en los widgets de tabla. Los elementos suelen contener texto, iconos o casillas de selección
La clase `QTableWidgetItem` es una clase de conveniencia que sustituye a la clase ` QTableItem ` en Qt 3. Proporciona un elemento para su uso con la clase ` QTableWidget `.
Los elementos de nivel superior se crean sin un elemento padre y, a continuación, se insertan en la posición especificada por un par de números de fila y columna:
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
pow(row, column+1)));
tableWidget->setItem(row, column, newItem);Cada elemento puede tener su propio pincel de fondo, que se establece con la función ` setBackground()`. El pincel de fondo actual se puede obtener con ` background()`. La etiqueta de texto de cada elemento se puede representar con su propia fuente y pincel. Estos se especifican con las funciones ` setFont()` y ` setForeground()`, y se leen con ` font()` y ` foreground()`.
Por defecto, los elementos están habilitados, son editables, seleccionables y marcables, y pueden utilizarse tanto como origen de una operación de arrastrar y soltar como destino de dicha operación. Los indicadores de cada elemento pueden modificarse llamando a setFlags() con el valor adecuado (véase Qt::ItemFlags). Los elementos marcables se pueden marcar y desmarcar con la función setCheckState(). La función correspondiente checkState() indica si el elemento está marcado actualmente.
Subclasificación
Al crear subclases de `QTableWidgetItem` para proporcionar elementos personalizados, es posible definir nuevos tipos para ellos, de modo que puedan distinguirse de los elementos estándar. Los constructores de las subclases que requieran esta característica deben llamar al constructor de la clase base con un valor de tipo nuevo igual o mayor que ` UserType`.
Véase también QTableWidget, Programación Modelo/Vista, QListWidgetItem y QTreeWidgetItem.
Documentación sobre tipos de miembro
enum QTableWidgetItem::ItemType
Esta enumeración describe los tipos que se utilizan para definir los elementos del widget de tabla.
| Constante | Valor | Descripción |
|---|---|---|
QTableWidgetItem::Type | 0 | El tipo predeterminado para los elementos del widget de tabla. |
QTableWidgetItem::UserType | 1000 | El valor mínimo para los tipos personalizados. Los valores inferiores a UserType están reservados por Qt. |
Se pueden definir nuevos tipos de usuario en subclases de ` QTableWidgetItem ` para garantizar que los elementos personalizados reciban un tratamiento especial.
Véase también type().
Documentación de funciones miembro
[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)
Crea un elemento de tabla del tipo « type » especificado que no pertenece a ninguna tabla.
Véase también type().
[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)
Crea un elemento de tabla con el « text » indicado.
Véase también type().
[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
Crea un elemento de tabla con los valores indicados en « icon » y « text ».
Véase también type().
QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)
Crea una copia de ` other`. Ten en cuenta que ` type()` y ` tableWidget()` no se copian.
Esta función resulta útil a la hora de reimplementar clone().
Véanse también data() y flags().
[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()
Elimina el elemento de la tabla.
QBrush QTableWidgetItem::background() const
Devuelve el pincel utilizado para renderizar el fondo del elemento.
Véase también setBackground() y foreground().
Qt::CheckState QTableWidgetItem::checkState() const
Devuelve el estado de selección del elemento de la tabla.
Véase también setCheckState() y flags().
[virtual] QTableWidgetItem *QTableWidgetItem::clone() const
Crea una copia del elemento.
int QTableWidgetItem::column() const
Devuelve la columna del elemento en la tabla. Si el elemento no se encuentra en una tabla, esta función devolverá -1.
Véase también row().
[virtual] QVariant QTableWidgetItem::data(int role) const
Devuelve los datos del elemento correspondiente a la role especificada.
Véase también setData().
Qt::ItemFlags QTableWidgetItem::flags() const
Devuelve los indicadores que se utilizan para describir el elemento. Estos determinan si el elemento se puede marcar, editar y seleccionar.
Véase también setFlags().
QFont QTableWidgetItem::font() const
Devuelve la fuente utilizada para mostrar el texto del elemento.
Véase también setFont().
QBrush QTableWidgetItem::foreground() const
Devuelve el pincel utilizado para representar el primer plano del elemento (por ejemplo, el texto).
Véase también setForeground() y background().
QIcon QTableWidgetItem::icon() const
Devuelve el icono del elemento.
Véase también setIcon() y iconSize.
bool QTableWidgetItem::isSelected() const
Devuelve « true » si el elemento está seleccionado; en caso contrario, devuelve « false ».
Véase también setSelected().
[virtual] void QTableWidgetItem::read(QDataStream &in)
Lee el elemento del flujo in.
Véase también write().
int QTableWidgetItem::row() const
Devuelve la fila del elemento en la tabla. Si el elemento no se encuentra en ninguna tabla, esta función devolverá -1.
Véase también column().
void QTableWidgetItem::setBackground(const QBrush &brush)
Establece el pincel de fondo del elemento en el brush especificado. Si se establece un pincel creado de forma predeterminada, la vista utilizará el color predeterminado del estilo.
Véase también background() y setForeground().
void QTableWidgetItem::setCheckState(Qt::CheckState state)
Establece el estado de selección del elemento de la tabla en « state ».
Véase también ` checkState()`.
[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)
Establece los datos del elemento correspondiente a role como value.
Nota: La implementación por defecto considera que Qt::EditRole y Qt::DisplayRole hacen referencia a los mismos datos.
Véase también Qt::ItemDataRole y data().
void QTableWidgetItem::setFlags(Qt::ItemFlags flags)
Establece los indicadores del elemento según el valor especificado en flags. Estos determinan si el elemento se puede seleccionar o modificar.
Véase también flags().
void QTableWidgetItem::setFont(const QFont &font)
Establece la fuente utilizada para mostrar el texto del elemento en la fuente especificada font.
Véase también font(), setText() y setForeground().
void QTableWidgetItem::setForeground(const QBrush &brush)
Establece el pincel de primer plano del elemento en el brush especificado. Si se establece un pincel creado de forma predeterminada, la vista utilizará el color predeterminado del estilo.
Véase también foreground() y setBackground().
void QTableWidgetItem::setIcon(const QIcon &icon)
Establece el icono del elemento en el icon especificado.
Véase también icon(), setText() y iconSize.
void QTableWidgetItem::setSelected(bool select)
Establece el estado seleccionado del elemento en « select ».
Véase también isSelected().
void QTableWidgetItem::setSizeHint(const QSize &size)
Establece la indicación de tamaño para el elemento de la tabla en size. Si no se establece ninguna indicación de tamaño o si size no es válido, el delegado del elemento calculará la indicación de tamaño basándose en los datos del elemento.
Véase también sizeHint().
void QTableWidgetItem::setStatusTip(const QString &statusTip)
Establece el texto de ayuda sobre el estado del elemento de la tabla con el texto especificado en statusTip. QTableWidget Es necesario tener activado el seguimiento del ratón para que esta función funcione.
Véase también statusTip(), setToolTip() y setWhatsThis().
void QTableWidgetItem::setText(const QString &text)
Establece el texto del elemento en el text especificado.
Véase también text(), setFont() y setForeground().
[since 6.4] void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)
Establece la alineación del texto del elemento según el valor especificado en « alignment ».
Esta función se introdujo en Qt 6.4.
Véase también textAlignment().
void QTableWidgetItem::setToolTip(const QString &toolTip)
Establece la descripción emergente del elemento con la cadena especificada en toolTip.
Véase también toolTip(), setStatusTip() y setWhatsThis().
void QTableWidgetItem::setWhatsThis(const QString &whatsThis)
Establece la ayuda «¿Qué es esto?» del elemento en la cadena especificada en whatsThis.
Véase también whatsThis(), setStatusTip() y setToolTip().
QSize QTableWidgetItem::sizeHint() const
Devuelve la sugerencia de tamaño establecida para el elemento de la tabla.
Véase también setSizeHint().
QString QTableWidgetItem::statusTip() const
Devuelve la descripción del estado del elemento.
Véase también setStatusTip().
QTableWidget *QTableWidgetItem::tableWidget() const
Devuelve el widget de tabla que contiene el elemento.
QString QTableWidgetItem::text() const
Devuelve el texto del elemento.
Véase también setText().
int QTableWidgetItem::textAlignment() const
Devuelve la alineación del texto del elemento.
Nota: Esta función devuelve un entero por motivos históricos. En Qt 7 se corregirá para que devuelva Qt::Alignment.
Véase también ` setTextAlignment()` y ` Qt::Alignment`.
QString QTableWidgetItem::toolTip() const
Devuelve la descripción emergente del elemento.
Véase también setToolTip().
int QTableWidgetItem::type() const
Devuelve el tipo pasado al constructor ` QTableWidgetItem `.
QString QTableWidgetItem::whatsThis() const
Devuelve la ayuda «¿Qué es esto?» del elemento.
Véase también setWhatsThis().
[virtual] void QTableWidgetItem::write(QDataStream &out) const
Escribe el elemento en el flujo out.
Véase también read().
[virtual] bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const
Devuelve « true » si el elemento es menor que el elemento de « other »; en caso contrario, devuelve «false».
QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
Asigna los datos y los indicadores de ` other` a este elemento. Ten en cuenta que ` type()` y ` tableWidget()` no se copian.
Esta función resulta útil a la hora de reimplementar clone().
Elementos no miembros relacionados
QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)
Escribe el elemento del widget de tabla « item » en el flujo « out ».
Este operador utiliza QTableWidgetItem::write().
Véase también «Serialización detipos de datos de Qt».
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)
Lee un elemento del widget de tabla desde el flujo « in » y lo guarda en « item ».
Este operador utiliza QTableWidgetItem::read().
Véase también «Serialización detipos de datos de Qt».
© 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.