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 |