QTextTableCell¶

Synopsis¶

Functions¶

def __eq__ (other)
def __ne__ (other)
def begin ()
def column ()
def columnSpan ()
def end ()
def firstCursorPosition ()
def firstPosition ()
def format ()
def isValid ()
def lastCursorPosition ()
def lastPosition ()
def row ()
def rowSpan ()
def setFormat (format)
def tableCellFormatIndex ()

Detailed Description¶

The PySide.QtGui.QTextTableCell class represents the properties of a cell in a PySide.QtGui.QTextTable .

Table cells are pieces of document structure that belong to a table. The table orders cells into particular rows and columns; cells can also span multiple columns and rows.

Cells are usually created when a table is inserted into a document with QTextCursor.insertTable() , but they are also created and destroyed when a table is resized.

Cells contain information about their location in a table; you can obtain the PySide.QtGui.QTextTableCell.row() and PySide.QtGui.QTextTableCell.column() numbers of a cell, and its PySide.QtGui.QTextTableCell.rowSpan() and PySide.QtGui.QTextTableCell.columnSpan() .

The PySide.QtGui.QTextTableCell.format() of a cell describes the default character format of its contents. The PySide.QtGui.QTextTableCell.firstCursorPosition() and PySide.QtGui.QTextTableCell.lastCursorPosition() functions are used to obtain the extent of the cell in the document.

See also

PySide.QtGui.QTextTable PySide.QtGui.QTextTableFormat

class PySide.QtGui.QTextTableCell¶

class PySide.QtGui.QTextTableCell(o)

Parameters:	o – `PySide.QtGui.QTextTableCell`

Constructs an invalid table cell.

See also

PySide.QtGui.QTextTableCell.isValid()

Copy constructor. Creates a new PySide.QtGui.QTextTableCell object based on the other cell.

PySide.QtGui.QTextTableCell.begin()¶

Return type:	`PySide.QtGui.QTextFrame::iterator`

Returns a frame iterator pointing to the beginning of the table’s cell.

See also

PySide.QtGui.QTextTableCell.end()

PySide.QtGui.QTextTableCell.column()¶

Return type:	`PySide.QtCore.int`

Returns the number of the column in the table that contains this cell.

See also

PySide.QtGui.QTextTableCell.row()

PySide.QtGui.QTextTableCell.columnSpan()¶

Return type:	`PySide.QtCore.int`

Returns the number of columns this cell spans. The default is 1.

See also

PySide.QtGui.QTextTableCell.rowSpan()

PySide.QtGui.QTextTableCell.end()¶

Return type:	`PySide.QtGui.QTextFrame::iterator`

Returns a frame iterator pointing to the end of the table’s cell.

See also

PySide.QtGui.QTextTableCell.begin()

PySide.QtGui.QTextTableCell.firstCursorPosition()¶

Return type:	`PySide.QtGui.QTextCursor`

Returns the first valid cursor position in this cell.

PySide.QtGui.QTextTableCell.firstPosition()¶

Return type:	`PySide.QtCore.int`

Returns the first valid position in the document occupied by this cell.

PySide.QtGui.QTextTableCell.format()¶

Return type:	`PySide.QtGui.QTextCharFormat`

Returns the cell’s character format.

PySide.QtGui.QTextTableCell.isValid()¶

Return type:	`PySide.QtCore.bool`

Returns true if this is a valid table cell; otherwise returns false.

PySide.QtGui.QTextTableCell.lastCursorPosition()¶

Return type:	`PySide.QtGui.QTextCursor`

Returns the last valid cursor position in this cell.

PySide.QtGui.QTextTableCell.lastPosition()¶

Return type:	`PySide.QtCore.int`

Returns the last valid position in the document occupied by this cell.

PySide.QtGui.QTextTableCell.__ne__(other)¶

Parameters:	other – `PySide.QtGui.QTextTableCell`
Return type:	`PySide.QtCore.bool`

Returns true if this cell object and the other cell object describe different cells; otherwise returns false.

PySide.QtGui.QTextTableCell.__eq__(other)¶

Parameters:	other – `PySide.QtGui.QTextTableCell`
Return type:	`PySide.QtCore.bool`

Returns true if this cell object and the other cell object describe the same cell; otherwise returns false.

PySide.QtGui.QTextTableCell.row()¶

Return type:	`PySide.QtCore.int`

Returns the number of the row in the table that contains this cell.

See also

PySide.QtGui.QTextTableCell.column()

PySide.QtGui.QTextTableCell.rowSpan()¶

Return type:	`PySide.QtCore.int`

Returns the number of rows this cell spans. The default is 1.

PySide.QtGui.QTextTableCell.setFormat(format)¶

Parameters:	format – `PySide.QtGui.QTextCharFormat`

Sets the cell’s character format to format . This can for example be used to change the background color of the entire cell:

PySide.QtGui.QTextTableCell cell = table->cellAt(2, 3); PySide.QtGui.QTextCharFormat format = cell. PySide.QtGui.QTextTableCell.format() ; format.setBackground( Qt.blue ); cell.setFormat(format);

Note that the cell’s row or column span cannot be changed through this function. You have to use QTextTable::mergeCells and QTextTable::splitCell instead.

See also

PySide.QtGui.QTextTableCell.format()

PySide.QtGui.QTextTableCell.tableCellFormatIndex()¶