QTextTableCell Class | Qt GUI 5.15.19 (original) (raw)

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

Member Function Documentation

QTextTableCell::QTextTableCell(const QTextTableCell &other)

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

QTextTableCell::QTextTableCell()

Constructs an invalid table cell.

See also isValid().

QTextTableCell &QTextTableCell::operator=(const QTextTableCell &other)

Assigns the other table cell to this table cell.

QTextTableCell::~QTextTableCell()

Destroys the table cell.

QTextFrame::iterator QTextTableCell::begin() const

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

See also end().

int QTextTableCell::column() const

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

See also row().

int QTextTableCell::columnSpan() const

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

See also rowSpan().

QTextFrame::iterator QTextTableCell::end() const

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

See also begin().

QTextCursor QTextTableCell::firstCursorPosition() const

Returns the first valid cursor position in this cell.

See also lastCursorPosition().

QTextCharFormat QTextTableCell::format() const

Returns the cell's character format.

See also setFormat().

bool QTextTableCell::isValid() const

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

QTextCursor QTextTableCell::lastCursorPosition() const

Returns the last valid cursor position in this cell.

See also firstCursorPosition().

int QTextTableCell::row() const

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

See also column().

int QTextTableCell::rowSpan() const

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

See also columnSpan().

void QTextTableCell::setFormat(const QTextCharFormat &format)

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

This function was introduced in Qt 4.2.

See also format().

int QTextTableCell::tableCellFormatIndex() const

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

This function was introduced in Qt 4.5.

See also QTextDocument::allFormats().

bool QTextTableCell::operator!=(const QTextTableCell &other) const

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

bool QTextTableCell::operator==(const QTextTableCell &other) const

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