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.QTextFrame.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.QTextFrame.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()