QTableWidgetItem Class Reference · PyQt4 中文文檔

# QTableWidgetItem Class Reference ## [[QtGui](index.htm) module] 該QTableWidgetItem類提供的項目與使用[QTableWidget](qtablewidget.html)類。[More...](#details) ### Types * `enum ItemType { Type, UserType }` ### Methods * `__init__ (self, int?type?=?QTableWidgetItem.Type)` * `__init__ (self, QString?text, int?type?=?QTableWidgetItem.Type)` * `__init__ (self, QIcon?icon, QString?text, int?type?=?QTableWidgetItem.Type)` * `__init__ (self, QTableWidgetItem?other)` * `QBrush background (self)` * `QColor backgroundColor (self)` * `Qt.CheckState checkState (self)` * `QTableWidgetItem clone (self)` * `int column (self)` * `QVariant data (self, int?role)` * `Qt.ItemFlags flags (self)` * `QFont font (self)` * `QBrush foreground (self)` * `QIcon icon (self)` * `bool isSelected (self)` * `read (self, QDataStream?in)` * `int row (self)` * `setBackground (self, QBrush?brush)` * `setBackgroundColor (self, QColor?color)` * `setCheckState (self, Qt.CheckState?state)` * `setData (self, int?role, QVariant?value)` * `setFlags (self, Qt.ItemFlags?aflags)` * `setFont (self, QFont?afont)` * `setForeground (self, QBrush?brush)` * `setIcon (self, QIcon?aicon)` * `setSelected (self, bool?aselect)` * `setSizeHint (self, QSize?size)` * `setStatusTip (self, QString?astatusTip)` * `setText (self, QString?atext)` * `setTextAlignment (self, int?alignment)` * `setTextColor (self, QColor?color)` * `setToolTip (self, QString?atoolTip)` * `setWhatsThis (self, QString?awhatsThis)` * `QSize sizeHint (self)` * `QString statusTip (self)` * `QTableWidget tableWidget (self)` * `QString text (self)` * `int textAlignment (self)` * `QColor textColor (self)` * `QString toolTip (self)` * `int type (self)` * `QString whatsThis (self)` * `write (self, QDataStream?out)` ### Special Methods * `bool __ge__ (self, QTableWidgetItem?other)` * `bool __lt__ (self, QTableWidgetItem?other)` * * * ## Detailed Description 該QTableWidgetItem類提供的項目與使用[QTableWidget](qtablewidget.html)類。表項是用來存放部分信息的表的小部件。項目通常包含文字，圖標或復選框該QTableWidgetItem類是取代了一個方便的類`QTableItem`類的Qt 3 。它提供了一種用于產品的使用[QTableWidget](qtablewidget.html)類。頂級項目，沒有父母，然后在由一對行和列數的指定位置插入的構造： ``` QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg( pow(row, column+1))); tableWidget->setItem(row, column, newItem); ``` 每個項目都可以有自己的背景刷子設置與[setBackground](qtablewidgetitem.html#setBackground)（）函數。當前的背景刷可以找到[background](qtablewidgetitem.html#background)（）。每個項目的文本標籤可以有自己的字體和筆刷渲染。這些都與指定[setFont](qtablewidgetitem.html#setFont)（）和[setForeground](qtablewidgetitem.html#setForeground)（）函數，并讀取與[font](qtablewidgetitem.html#font)（）和[foreground](qtablewidgetitem.html#foreground)（）。默認情況下，項目的啟用，可編輯，可選擇辨認的，可同時用作拖動的來源又是釋放的操作和放置目標。每個項目的標志可以通過調用改變[setFlags](qtablewidgetitem.html#setFlags)（）用適當的值（見[Qt.ItemFlags](qt.html#ItemFlag-enum)）。辨認的項目可以選中和未選中的[setCheckState](qtablewidgetitem.html#setCheckState)（）函數。相應的[checkState](qtablewidgetitem.html#checkState)（）函數表示該項目目前是否已選中。 ### Subclassing 當子類化QTableWidgetItem提供自定義項目，可以為他們定義新類型，使他們能夠從標準的項目區別開來。該構造函數需要此功能的子類需要調用基類的構造函數有一個新的類型值等于或大于[UserType](qtablewidgetitem.html#ItemType-enum)。 * * * ## Type Documentation ``` QTableWidgetItem.ItemType ``` 這個枚舉變量描述了用于描述表部件項目的類型。 | Constant | Value | Description | | --- | --- | --- | | `QTableWidgetItem.Type` | `0` | 默認類型為表部件項目。 | | `QTableWidgetItem.UserType` | `1000` | 對于自定義類型的最小值。以下用戶等級和積分值被Qt保留。 | 您可以定義新的用戶類型[QTableWidgetItem](qtablewidgetitem.html)子類以確保自定義項目被特殊處理。 **See also** [type](qtablewidgetitem.html#type)（）。 * * * ## Method Documentation ``` QTableWidgetItem.__init__ (self, int?type?=?QTableWidgetItem.Type) ``` 構造一個指定的表項_type_不屬于任何表。 **See also** [type](qtablewidgetitem.html#type)（）。 ``` QTableWidgetItem.__init__ (self, QString?text, int?type?=?QTableWidgetItem.Type) ``` 構造具有給定一個表項_text_。 **See also** [type](qtablewidgetitem.html#type)（）。 ``` QTableWidgetItem.__init__ (self, QIcon?icon, QString?text, int?type?=?QTableWidgetItem.Type) ``` 構造具有給定一個表項_icon_和_text_。 **See also** [type](qtablewidgetitem.html#type)（）。 ``` QTableWidgetItem.__init__ (self, QTableWidgetItem?other) ``` 構造的副本_other_。需要注意的是[type](qtablewidgetitem.html#type)（）和[tableWidget](qtablewidgetitem.html#tableWidget)（）不會被復制。重新實現時，此功能非常有用[clone](qtablewidgetitem.html#clone)（）。這個函數是Qt 4.1中引入。 **See also** [data](qtablewidgetitem.html#data)（）和[flags](qtablewidgetitem.html#flags)（）。 ``` QBrush QTableWidgetItem.background (self) ``` [ 返回用于呈現項的背景的畫筆。這個函數中引入了Qt 4.2中。 ](qbrush.html) [**See also**](qbrush.html) [setBackground](qtablewidgetitem.html#setBackground)（）和[foreground](qtablewidgetitem.html#foreground)（）。 ``` QColor QTableWidgetItem.backgroundColor (self) ``` [](qcolor.html) ``` Qt.CheckState QTableWidgetItem.checkState (self) ``` [ 返回表項的選中狀態。 ](qt.html#CheckState-enum) [**See also**](qt.html#CheckState-enum) [setCheckState](qtablewidgetitem.html#setCheckState)（）和[flags](qtablewidgetitem.html#flags)（）。 ``` QTableWidgetItem QTableWidgetItem.clone (self) ``` [ 創建項目的副本。 ``` int QTableWidgetItem.column (self) ``` 返回表中的該項目的列。如果項目是不是在一個表中，該函數將返回-1 。這個函數中引入了Qt 4.2中。 ](qtablewidgetitem.html) [**See also**](qtablewidgetitem.html) [row](qtablewidgetitem.html#row)（）。 ``` QVariant QTableWidgetItem.data (self, int?role) ``` 返回的項目的數據為給定的_role_。 **See also** [setData](qtablewidgetitem.html#setData)（）。 ``` Qt.ItemFlags QTableWidgetItem.flags (self) ``` [ 返回用于描述產品的標志。這些判斷項目是否可以被檢查，編輯和選擇。 ](index.htm) [**See also**](index.htm) [setFlags](qtablewidgetitem.html#setFlags)（）。 ``` QFont QTableWidgetItem.font (self) ``` [ 返回用于呈現項的文本的字體。 ](qfont.html) [**See also**](qfont.html) [setFont](qtablewidgetitem.html#setFont)（）。 ``` QBrush QTableWidgetItem.foreground (self) ``` [ 返回用于呈現項目的前景（如文字）的筆刷。這個函數中引入了Qt 4.2中。 ](qbrush.html) [**See also**](qbrush.html) [setForeground](qtablewidgetitem.html#setForeground)（）和[background](qtablewidgetitem.html#background)（）。 ``` QIcon QTableWidgetItem.icon (self) ``` [ 返回該項目的圖標。 ](qicon.html) [**See also**](qicon.html) [setIcon](qtablewidgetitem.html#setIcon)（）和[iconSize](qabstractitemview.html#iconSize-prop)。 ``` bool QTableWidgetItem.isSelected (self) ``` 返回True如果該項目被選中，否則返回False 。這個函數中引入了Qt 4.2中。 **See also** [setSelected](qtablewidgetitem.html#setSelected)（）。 ``` QTableWidgetItem.read (self, QDataStream?in) ``` 從流中讀取的項目_in_。 **See also** [write](qtablewidgetitem.html#write)（）。 ``` int QTableWidgetItem.row (self) ``` 返回表中的項的行。如果項目是不是在一個表中，該函數將返回-1 。這個函數中引入了Qt 4.2中。 **See also** [column](qtablewidgetitem.html#column)（）。 ``` QTableWidgetItem.setBackground (self, QBrush?brush) ``` 設置項的背景刷到指定的_brush_。這個函數中引入了Qt 4.2中。 **See also** [background](qtablewidgetitem.html#background)（）和[setForeground](qtablewidgetitem.html#setForeground)（）。 ``` QTableWidgetItem.setBackgroundColor (self, QColor?color) ``` ``` QTableWidgetItem.setCheckState (self, Qt.CheckState?state) ``` 設置表項的檢查狀態是_state_。 **See also** [checkState](qtablewidgetitem.html#checkState)（）。 ``` QTableWidgetItem.setData (self, int?role, QVariant?value) ``` 設置項的數據為給定的_role_到指定的_value_。 **See also** [Qt.ItemDataRole](qt.html#ItemDataRole-enum)和[data](qtablewidgetitem.html#data)（）。 ``` QTableWidgetItem.setFlags (self, Qt.ItemFlags?aflags) ``` 設置標志的項，以給定的_flags_。這些決定了項目是否可以選擇或修改。 **See also** [flags](qtablewidgetitem.html#flags)（）。 ``` QTableWidgetItem.setFont (self, QFont?afont) ``` 設置用于顯示項目的文字給定的字體_font_。 **See also** [font](qtablewidgetitem.html#font)（）[setText](qtablewidgetitem.html#setText)（）和[setForeground](qtablewidgetitem.html#setForeground)（）。 ``` QTableWidgetItem.setForeground (self, QBrush?brush) ``` 設置項的前景色刷到指定的_brush_。這個函數中引入了Qt 4.2中。 **See also** [foreground](qtablewidgetitem.html#foreground)（）和[setBackground](qtablewidgetitem.html#setBackground)（）。 ``` QTableWidgetItem.setIcon (self, QIcon?aicon) ``` 設置項的圖標_icon_規定。 **See also** [icon](qtablewidgetitem.html#icon)（）[setText](qtablewidgetitem.html#setText)（）和[iconSize](qabstractitemview.html#iconSize-prop)。 ``` QTableWidgetItem.setSelected (self, bool?aselect) ``` 設置項的選擇狀態，以_select_。這個函數中引入了Qt 4.2中。 **See also** [isSelected](qtablewidgetitem.html#isSelected)（）。 ``` QTableWidgetItem.setSizeHint (self, QSize?size) ``` 設置尺寸暗示的表項是_size_。如果沒有大小的提示設置，基于項目數據的項目代表將計算尺寸暗示。這個函數是Qt 4.1中引入。 **See also** [sizeHint](qtablewidgetitem.html#sizeHint)（）。 ``` QTableWidgetItem.setStatusTip (self, QString?astatusTip) ``` 設置狀態提示為表項所指定的文本_statusTip_。[QTableWidget](qtablewidget.html)鼠標跟蹤需要啟用此功能工作。 **See also** [statusTip](qtablewidgetitem.html#statusTip)（）[setToolTip](qtablewidgetitem.html#setToolTip)（）和[setWhatsThis](qtablewidgetitem.html#setWhatsThis)（）。 ``` QTableWidgetItem.setText (self, QString?atext) ``` 設置項的文字到_text_規定。 **See also** [text](qtablewidgetitem.html#text)（）[setFont](qtablewidgetitem.html#setFont)（）和[setForeground](qtablewidgetitem.html#setForeground)（）。 ``` QTableWidgetItem.setTextAlignment (self, int?alignment) ``` 設置文本對齊方式為項目的文字到_alignment_規定。 **See also** [textAlignment](qtablewidgetitem.html#textAlignment)（）和[Qt.Alignment](qt.html#AlignmentFlag-enum)。 ``` QTableWidgetItem.setTextColor (self, QColor?color) ``` ``` QTableWidgetItem.setToolTip (self, QString?atoolTip) ``` 設置項的提示通過指定的字符串_toolTip_。 **See also** [toolTip](qtablewidgetitem.html#toolTip)（）[setStatusTip](qtablewidgetitem.html#setStatusTip)（）和[setWhatsThis](qtablewidgetitem.html#setWhatsThis)（）。 ``` QTableWidgetItem.setWhatsThis (self, QString?awhatsThis) ``` 設置項的“這是什么？ ”有助于通過指定的字符串_whatsThis_。 **See also** [whatsThis](qtablewidgetitem.html#whatsThis)（）[setStatusTip](qtablewidgetitem.html#setStatusTip)（）和[setToolTip](qtablewidgetitem.html#setToolTip)（）。 ``` QSize QTableWidgetItem.sizeHint (self) ``` [ 返回該表項的大小提示集。這個函數是Qt 4.1中引入。 ](qsize.html) [**See also**](qsize.html) [setSizeHint](qtablewidgetitem.html#setSizeHint)（）。 ``` QString QTableWidgetItem.statusTip (self) ``` 返回項目的狀態提示。 **See also** [setStatusTip](qtablewidgetitem.html#setStatusTip)（）。 ``` QTableWidget QTableWidgetItem.tableWidget (self) ``` [ 返回包含項目的表格部件。 ``` QString QTableWidgetItem.text (self) ``` 返回項的文本。 ](qtablewidget.html) [**See also**](qtablewidget.html) [setText](qtablewidgetitem.html#setText)（）。 ``` int QTableWidgetItem.textAlignment (self) ``` 返回文本對齊方式項的文本。 **See also** [setTextAlignment](qtablewidgetitem.html#setTextAlignment)（）和[Qt.Alignment](qt.html#AlignmentFlag-enum)。 ``` QColor QTableWidgetItem.textColor (self) ``` [ ``` QString QTableWidgetItem.toolTip (self) ``` 返回該項目的工具提示。 ](qcolor.html) [**See also**](qcolor.html) [setToolTip](qtablewidgetitem.html#setToolTip)（）。 ``` int QTableWidgetItem.type (self) ``` 返回傳遞給類型[QTableWidgetItem](qtablewidgetitem.html)構造函數。 ``` QString QTableWidgetItem.whatsThis (self) ``` 返回該項目的“這是什么？ ”幫助。 **See also** [setWhatsThis](qtablewidgetitem.html#setWhatsThis)（）。 ``` QTableWidgetItem.write (self, QDataStream?out) ``` 寫入流的項目_out_。 **See also** [read](qtablewidgetitem.html#read)（）。 ``` bool QTableWidgetItem.__ge__ (self, QTableWidgetItem?other) ``` ``` bool QTableWidgetItem.__lt__ (self, QTableWidgetItem?other) ```