En esta página

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

ConstanteValorDescripción
QTableWidgetItem::Type0El tipo predeterminado para los elementos del widget de tabla.
QTableWidgetItem::UserType1000El 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().

Véase también data() y flags().

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.