QTextTableCell Class Reference

Member Function Documentation

QTextTableCell::QTextTableCell ()

Constructs an invalid table cell.

See also isValid().

QTextTableCell::QTextTableCell ( const QTextTableCell & other )

Copy constructor. Creates a new QTextTableCell object based on the other 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.

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

Assigns the other table cell to this table cell.

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.