0、说明
QTableWidgetItem指明QTableWidget中的一个Item。Item通常包含文本、图标、checkbox。
最常用的构造Item的方式是：不指定该Item所在的TableWidget，之后通过对该TableWidget调用setItem( row , column , newItem )来往其中加入Item：
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg( pow(row, column+1))); tableWidget->setItem(row, column, newItem);
每个Item都有一个它自己的背景色，通过setBackground()设置；当前的背景色通过background()查看。此外，每个Item的文本字体和字体颜色通过setFont()、setForeground()设置，通过font()、foreground()查看。
默认情况下，所有Item都是激活的、可编辑的、可选择的、可检查的、可拖拽的。
1、模块和加载项
| Header: | #include <QTableWidgetItem> |
| qmake: | QT += widgets |
2、构造
| QTableWidgetItem(QTableWidgetItem other) | 获得另一个Item的副本 |
| QTableWidgetItem(QIcon icon, QString text, int type = Type) | 用指定Icon和Text构造一个Item |
| QTableWidgetItem(QString text, int type = Type) | 用指定Text构造一个Item |
| QTableWidgetItem(int type = Type) | 构造一个空Item |
3、静态字段
| enum | ItemType { Type, UserType } | Item的类型 |
| Constant | Value | Description |
|---|---|---|
QTableWidgetItem::Type |
0 |
The default type for table widget items. |
QTableWidgetItem::UserType |
1000 |
The minimum value for custom types. Values below UserType are reserved by Qt. |
6、实例方法
返回值类型 |
方法 |
说明 |
| virtual bool |
operator=(QTableWidgetItem other) operator<(QTableWidgetItem other) |
赋值
|
| QBrush | background() | Item背景色 |
| Qt::CheckState | checkState() | |
| virtual QTableWidgetItem * | clone() | |
| int | column() | Item所在列 |
| virtual QVariant | data(int role) | Item中对应Role为role的数据 |
| Qt::ItemFlags | flags() | |
| QFont | font() | 字体 |
| QBrush | foreground() | 字体颜色 |
| QIcon | icon() | 图标 |
| bool | isSelected() | 是否选中 |
| virtual void | read(QDataStream &in) | 从in中读取Item |
| int | row() | Item所在行 |
| void | setBackground(QBrush brush) | 设置背景色 |
| setCheckState(Qt::CheckState state) | ||
| setData(int role, QVariant value) | 设置该Item的Role为role的data | |
| setFlags(Qt::ItemFlags flags) | ||
| setFont(QFont font) | 设置字体 | |
| setForeground(QBrush brush) | 设置字体颜色 | |
| setIcon(QIcon icon) | 设置Icon | |
| setSelected(bool select) | 设置是否选中 | |
| setSizeHint(QSize size) | 设置SizeHint | |
| setStatusTip(QString statusTip) | 设置状态文本 | |
| setText(QString text) | 设置显示文本 | |
| setTextAlignment(int alignment) | 设置对齐 | |
| setToolTip(QString toolTip) | 设置工具文本 | |
| setWhatsThis(QString whatsThis) | 设置帮助文本 | |
| QSize | sizeHint() | Size Hint |
| QString | statusTip() | 状态文本 |
| QTableWidget * | tableWidget() | Item所在的TableWidget |
| QString | text() | 显示文本 |
| int | textAlignment() | 对齐 |
| QString | toolTip() | 工具文本 |
| int | type() | 类型 |
| QString | whatsThis() | 帮助文本 |
| virtual bool | write(QDataStream &out) | 将该Item写入out |