En esta página

QTableWidgetItem Class

La clase QTableWidgetItem proporciona un elemento para su uso con la clase QTableWidget. Más...

Cabecera: #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 contener piezas de información para los widgets de tabla. Los ítems suelen contener texto, iconos o casillas de verificación.

La clase QTableWidgetItem es una clase de conveniencia que reemplaza a la clase QTableItem en Qt 3. Proporciona un elemento para su uso con la clase QTableWidget.

Los elementos de nivel superior se construyen sin un padre y 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 puede encontrarse con background(). La etiqueta de texto de cada elemento puede representarse 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 activados, son editables, seleccionables, comprobables y pueden utilizarse como origen de una operación de arrastrar y soltar y como destino de una operación de soltar. Los indicadores de cada elemento pueden cambiarse llamando a setFlags() con el valor apropiado (véase Qt::ItemFlags). Los elementos que se pueden marcar se pueden marcar y desmarcar con la función setCheckState(). La función checkState() correspondiente indica si el elemento está actualmente marcado.

Subclase

Al subclasificar QTableWidgetItem para proporcionar ítems personalizados, es posible definir nuevos tipos para ellos de forma que puedan distinguirse de los ítems 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 superior a UserType.

Véase también QTableWidget, Programación Modelo/Vista, QListWidgetItem, y QTreeWidgetItem.

Documentación de tipos miembros

enum QTableWidgetItem::ItemType

Este enum describe los tipos que se utilizan para describir los elementos del widget de tabla.

ConstanteValorDescripción
QTableWidgetItem::Type0El tipo por defecto para los elementos del widget de tabla.
QTableWidgetItem::UserType1000El valor mínimo para tipos personalizados. Los valores por debajo de UserType están reservados por Qt.

Puede definir nuevos tipos de usuario en las subclases de QTableWidgetItem para asegurarse de que los elementos personalizados reciben un tratamiento especial.

Véase también type().

Documentación de las funciones miembro

[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)

Construye un elemento de tabla de la dirección type especificada que no pertenece a ninguna tabla.

Véase también type().

[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)

Construye un elemento de tabla con la dirección text.

Véase también type().

[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)

Construye un elemento de tabla con los datos icon y text.

Véase también type().

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

Construye una copia de other. Tenga en cuenta que type() y tableWidget() no se copian.

Esta función es útil cuando se reimplementa clone().

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

[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()

Destruye el elemento de la tabla.

QBrush QTableWidgetItem::background() const

Devuelve el pincel utilizado para representar el fondo del elemento.

Véase también setBackground() y foreground().

Qt::CheckState QTableWidgetItem::checkState() const

Devuelve el estado comprobado 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 está 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 para el role dado.

Véase también setData().

Qt::ItemFlags QTableWidgetItem::flags() const

Devuelve los indicadores utilizados para describir el elemento. Éstas determinan si el elemento se puede comprobar, editar y seleccionar.

Véase también setFlags().

QFont QTableWidgetItem::font() const

Devuelve la fuente utilizada para representar 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, 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 está en una 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. Establecer un pincel construido por defecto permitirá a la vista utilizar el color por defecto del estilo.

Véase también background() y setForeground().

void QTableWidgetItem::setCheckState(Qt::CheckState state)

Establece el estado de comprobació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 para el role dado en el value especificado.

Nota: La implementación por defecto considera que Qt::EditRole y Qt::DisplayRole se refieren a los mismos datos.

Véase también Qt::ItemDataRole y data().

void QTableWidgetItem::setFlags(Qt::ItemFlags flags)

Establece los indicadores del elemento en la dirección flags. Esto determina si el elemento puede ser seleccionado o modificado.

Véase también flags().

void QTableWidgetItem::setFont(const QFont &font)

Establece el tipo de letra utilizado para mostrar el texto del elemento en 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. Establecer un pincel construido por defecto permitirá a la vista utilizar el color por defecto 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 el tamaño del elemento de la tabla en size. Si no se establece ninguna indicación de tamaño o size no es válida, 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 la información de estado para el elemento de la tabla en el texto especificado por statusTip. El seguimiento del ratón QTableWidget debe estar activado 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)

Ajusta la alineación del texto del elemento a la dirección alignment especificada.

Esta función se introdujo en Qt 6.4.

Véase también textAlignment().

void QTableWidgetItem::setToolTip(const QString &toolTip)

Establece la información sobre herramientas del elemento en la cadena especificada por 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 por 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 el consejo de 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 int por razones históricas. Será corregida para devolver Qt::Alignment en Qt 7.

Véase también setTextAlignment() y Qt::Alignment.

QString QTableWidgetItem::toolTip() const

Devuelve la descripción 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 other; en caso contrario devuelve false.

QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)

Asigna los datos y banderas de other a este elemento. Tenga en cuenta que type() y tableWidget() no se copian.

Esta función es útil cuando se reimplementa clone().

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

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 Serializar tipos de datos Qt.

QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)

Lee un elemento de widget de tabla del flujo in a item.

Este operador utiliza QTableWidgetItem::read().

Véase también Serializar tipos de datos 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.