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) |
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 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.
| Constante | Valor | Descripción |
|---|---|---|
QTableWidgetItem::Type | 0 | El tipo por defecto para los elementos del widget de tabla. |
QTableWidgetItem::UserType | 1000 | El 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().
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.