Home · All Classes · Modules

QTableWidgetItem Class Reference
^{^{[QtGui module]}}

The QTableWidgetItem class provides an item for use with the QTableWidget class. More...

Types

enum ItemType { Type, UserType }

Methods

__init__ (self, int type = QTableWidgetItem.Type)
__init__ (self, QString, int type = QTableWidgetItem.Type)
__init__ (self, QIcon, QString, int type = QTableWidgetItem.Type)
__init__ (self, QTableWidgetItem)
QBrush background (self)
QColor backgroundColor (self)
Qt.CheckState checkState (self)
QTableWidgetItem clone (self)
int column (self)
QVariant data (self, int)
Qt.ItemFlags flags (self)
QFont font (self)
QBrush foreground (self)
QIcon icon (self)
bool isSelected (self)
read (self, QDataStream)
int row (self)
setBackground (self, QBrush)
setBackgroundColor (self, QColor)
setCheckState (self, Qt.CheckState)
setData (self, int, QVariant)
setFlags (self, Qt.ItemFlags)
setFont (self, QFont)
setForeground (self, QBrush)
setIcon (self, QIcon)
setSelected (self, bool)
setSizeHint (self, QSize)
setStatusTip (self, QString)
setText (self, QString)
setTextAlignment (self, int)
setTextColor (self, QColor)
setToolTip (self, QString)
setWhatsThis (self, QString)
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)

Special Methods

bool __ge__ (self, QTableWidgetItem)
bool __lt__ (self, QTableWidgetItem)

Detailed Description

The QTableWidgetItem class provides an item for use with the QTableWidget class.

Table items are used to hold pieces of information for table widgets. Items usually contain text, icons, or checkboxes

The QTableWidgetItem class is a convenience class that replaces the QTableItem class in Qt 3. It provides an item for use with the QTableWidget class.

Top-level items are constructed without a parent then inserted at the position specified by a pair of row and column numbers:

     QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
         pow(row, column+1)));
     tableWidget->setItem(row, column, newItem);

Each item can have its own background brush which is set with the setBackground() function. The current background brush can be found with background(). The text label for each item can be rendered with its own font and brush. These are specified with the setFont() and setForeground() functions, and read with font() and foreground().

By default, items are enabled, editable, selectable, checkable, and can be used both as the source of a drag and drop operation and as a drop target. Each item's flags can be changed by calling setFlags() with the appropriate value (see Qt.ItemFlags). Checkable items can be checked and unchecked with the setCheckState() function. The corresponding checkState() function indicates whether the item is currently checked.

Subclassing

When subclassing QTableWidgetItem to provide custom items, it is possible to define new types for them so that they can be distinguished from standard items. The constructors for subclasses that require this feature need to call the base class constructor with a new type value equal to or greater than UserType.

Type Documentation

QTableWidgetItem.ItemType

This enum describes the types that are used to describe table widget items.

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.

You can define new user types in QTableWidgetItem subclasses to ensure that custom items are treated specially.

See also type().