QTextTableCell Class
The QTextTableCell class represents the properties of a cell in a QTextTable. 更多...
| 头文件: | #include <QTextTableCell> |
| qmake: | QT += gui |
Note: All functions in this class are reentrant.
公有函数
| QTextTableCell() | |
| QTextTableCell(const QTextTableCell &other) | |
| ~QTextTableCell() | |
| QTextFrame::iterator | begin() const |
| int | column() const |
| int | columnSpan() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| QTextCharFormat | format() const |
| bool | isValid() const |
| QTextCursor | lastCursorPosition() const |
| int | row() const |
| int | rowSpan() const |
| void | setFormat(const QTextCharFormat &format) |
| int | tableCellFormatIndex() const |
| bool | operator!=(const QTextTableCell &other) const |
| QTextTableCell & | operator=(const QTextTableCell &other) |
| bool | operator==(const QTextTableCell &other) const |
详细描述
The QTextTableCell class represents the properties of a cell in a 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 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.
参见 QTextTable and QTextTableFormat.
成员函数
QTextTableCell::QTextTableCell()
Constructs an invalid table cell.
参见 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.
参见 end().
int QTextTableCell::column() const
Returns the number of the column in the table that contains this cell.
参见 row().
int QTextTableCell::columnSpan() const
Returns the number of columns this cell spans. The default is 1.
参见 rowSpan().
QTextFrame::iterator QTextTableCell::end() const
Returns a frame iterator pointing to the end of the table's cell.
参见 begin().
QTextCursor QTextTableCell::firstCursorPosition() const
Returns the first valid cursor position in this cell.
参见 lastCursorPosition().
QTextCharFormat QTextTableCell::format() const
Returns the cell's character format.
参见 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.
参见 firstCursorPosition().
int QTextTableCell::row() const
Returns the number of the row in the table that contains this cell.
参见 column().
int QTextTableCell::rowSpan() const
Returns the number of rows this cell spans. The default is 1.
参见 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.
参见 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.
参见 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.