Home · All Classes · Modules

QTableWidgetItem Class Reference
^{[QtGui module]}

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

Methods

• __init__ (self, int type = QTableWidgetItem.Type)
• __init__ (self, QString text, int type = QTableWidgetItem.Type)
• __init__ (self, QTableWidgetItem other)
• QColor backgroundColor (self)
• Qt.CheckState checkState (self)
• QTableWidgetItem clone (self)
• QVariant data (self, int role)
• Qt.ItemFlags flags (self)
• QFont font (self)
• QIcon icon (self)
• read (self, QDataStream in)
• setBackgroundColor (self, QColor color)
• setCheckState (self, Qt.CheckState state)
• setData (self, int role, QVariant value)
• setFlags (self, Qt.ItemFlags aflags)
• setFont (self, QFont afont)
• setIcon (self, QIcon aicon)
• 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 __lt__ (self, QTableWidgetItem other)

Static Members

• int Type
• int UserType

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 color which is set with the setBackgroundColor() function. The current background color can be found with backgroundColor(). The text label for each item can be rendered with its own font and text color. These are specified with the setFont() and setTextColor() functions, and read with font() and textColor().

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 setChecked() function. The corresponding checked() function indicates whether the item is currently checked.

See also QTableWidget, Model/View Programming, QListWidgetItem, and QTreeWidgetItem.

Method Documentation

QTableWidgetItem.__init__ (self, int type = QTableWidgetItem.Type)

Constructs a table item of the specified type that does not belong to any table.

See also type().

QTableWidgetItem.__init__ (self, QString text, int type = QTableWidgetItem.Type)

Constructs a table item with the given text.

See also type().

QTableWidgetItem.__init__ (self, QTableWidgetItem other)

Constructs a copy of other. Note that type() and tableWidget() are not copied.

This function is useful when reimplementing clone().

This function was introduced in Qt 4.1.

See also data() and flags().

QColor QTableWidgetItem.backgroundColor (self)

Returns the color used to render the item's background.

See also textColor() and setBackgroundColor().

Qt.CheckState QTableWidgetItem.checkState (self)

Returns the checked state of the table item.

See also setCheckState() and flags().

QTableWidgetItem QTableWidgetItem.clone (self)

Creates a copy of the item.

QVariant QTableWidgetItem.data (self, int role)

Returns the item's data for the given role.

See also setData().

Qt.ItemFlags QTableWidgetItem.flags (self)

Returns the flags used to describe the item. These determine whether the item can be checked, edited, and selected.

See also setFlags().

QFont QTableWidgetItem.font (self)

Returns the font used to render the item's text.

See also setFont().

QIcon QTableWidgetItem.icon (self)

Returns the item's icon.

See also setIcon() and iconSize.

QTableWidgetItem.read (self, QDataStream in)

Reads the item from stream in.

See also write().

QTableWidgetItem.setBackgroundColor (self, QColor color)

Sets the item's background color to the specified color.

See also backgroundColor() and setTextColor().

QTableWidgetItem.setCheckState (self, Qt.CheckState state)

Sets the check state of the table item to be state.

See also checkState().

QTableWidgetItem.setData (self, int role, QVariant value)

Sets the item's data for the given role to the specified value.

See also Qt.ItemDataRole and data().

QTableWidgetItem.setFlags (self, Qt.ItemFlags aflags)

Sets the flags for the item to the given flags. These determine whether the item can be selected or modified.

See also flags().

QTableWidgetItem.setFont (self, QFont afont)

Sets the font used to display the item's text to the given font.

See also font(), setText(), and setTextColor().

QTableWidgetItem.setIcon (self, QIcon aicon)

Sets the item's icon to the icon specified.

See also icon(), setText(), and iconSize.

QTableWidgetItem.setSizeHint (self, QSize size)

Sets the size hint for the table item to be size. If no size hint is set, the item delegate will compute the size hint based on the item data.

This function was introduced in Qt 4.1.

See also sizeHint().

QTableWidgetItem.setStatusTip (self, QString astatusTip)

Sets the item's status tip to the string specified by statusTip.

See also statusTip(), setToolTip(), and setWhatsThis().

QTableWidgetItem.setText (self, QString atext)

Sets the item's text to the text specified.

See also text(), setFont(), and setTextColor().

QTableWidgetItem.setTextAlignment (self, int alignment)

Sets the text alignment for the item's text to the alignment specified.

See also textAlignment() and Qt.Alignment.

QTableWidgetItem.setTextColor (self, QColor color)

Sets the color used to display the item's text to the given color.

See also textColor(), setFont(), and setText().

QTableWidgetItem.setToolTip (self, QString atoolTip)

Sets the item's tooltip to the string specified by toolTip.

See also toolTip(), setStatusTip(), and setWhatsThis().

QTableWidgetItem.setWhatsThis (self, QString awhatsThis)

Sets the item's "What's This?" help to the string specified by whatsThis.

See also whatsThis(), setStatusTip(), and setToolTip().

QSize QTableWidgetItem.sizeHint (self)

Returns the size hint set for the table item.

This function was introduced in Qt 4.1.

See also setSizeHint().

QString QTableWidgetItem.statusTip (self)

Returns the item's status tip.

See also setStatusTip().

QTableWidget QTableWidgetItem.tableWidget (self)

Returns the table widget that contains the item.

QString QTableWidgetItem.text (self)

Returns the item's text.

See also setText().

int QTableWidgetItem.textAlignment (self)

Returns the text alignment for the item's text.

See also setTextAlignment() and Qt.Alignment.

QColor QTableWidgetItem.textColor (self)

Returns the color used to render the item's text.

See also backgroundColor() and setTextColor().

QString QTableWidgetItem.toolTip (self)

Returns the item's tooltip.

See also setToolTip().

int QTableWidgetItem.type (self)

Returns the type passed to the QTableWidgetItem constructor.

QString QTableWidgetItem.whatsThis (self)

Returns the item's "What's This?" help.

See also setWhatsThis().

QTableWidgetItem.write (self, QDataStream out)

Writes the item to stream out.

See also read().

bool QTableWidgetItem.__lt__ (self, QTableWidgetItem other)

Member Documentation

int Type

This member should be treated as a constant.

The default type for table widget items.

See also UserType and type().

int UserType

This member should be treated as a constant.

The minimum value for custom types. Values below UserType are reserved by Qt.

See also Type and type().