QTextTableCell

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

Inheritance diagram of PySide2.QtGui.QTextTableCell

Synopsis

Functions

Detailed Description

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 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 row() and column() numbers of a cell, and its rowSpan() and columnSpan() .

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

class PySide2.QtGui.QTextTableCell

PySide2.QtGui.QTextTableCell(o)

param o

PySide2.QtGui.QTextTableCell

Constructs an invalid table cell.

See also

isValid()

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

PySide2.QtGui.QTextTableCell.begin()
Return type

PySide2.QtGui.iterator

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

See also

end()

PySide2.QtGui.QTextTableCell.column()
Return type

int

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

See also

row()

PySide2.QtGui.QTextTableCell.columnSpan()
Return type

int

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

See also

rowSpan()

PySide2.QtGui.QTextTableCell.end()
Return type

PySide2.QtGui.iterator

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

See also

begin()

PySide2.QtGui.QTextTableCell.firstCursorPosition()
Return type

PySide2.QtGui.QTextCursor

Returns the first valid cursor position in this cell.

PySide2.QtGui.QTextTableCell.firstPosition()
Return type

int

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

PySide2.QtGui.QTextTableCell.format()
Return type

PySide2.QtGui.QTextCharFormat

Returns the cell’s character format.

See also

setFormat()

PySide2.QtGui.QTextTableCell.isValid()
Return type

bool

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

PySide2.QtGui.QTextTableCell.lastCursorPosition()
Return type

PySide2.QtGui.QTextCursor

Returns the last valid cursor position in this cell.

PySide2.QtGui.QTextTableCell.lastPosition()
Return type

int

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

PySide2.QtGui.QTextTableCell.__ne__(other)
Parameters

otherPySide2.QtGui.QTextTableCell

Return type

bool

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

PySide2.QtGui.QTextTableCell.__eq__(other)
Parameters

otherPySide2.QtGui.QTextTableCell

Return type

bool

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

PySide2.QtGui.QTextTableCell.row()
Return type

int

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

See also

column()

PySide2.QtGui.QTextTableCell.rowSpan()
Return type

int

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

See also

columnSpan()

PySide2.QtGui.QTextTableCell.setFormat(format)
Parameters

formatPySide2.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:

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

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

See also

format()

PySide2.QtGui.QTextTableCell.tableCellFormatIndex()
Return type

int

Returns the index of the tableCell’s format in the document’s internal list of formats.

See also

allFormats()