QTextTableCell 类

QTextTableCell 类表示 QTextTable 中单元格的属性。...

头文件	#include <QTextTableCell>
CMake	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake	QT += gui

所有成员列表，包括继承成员
QTextTableCell 是富文本处理 API 的一部分。

注意：本类中的所有函数均可重入。

公有函数

	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

详细描述

表格单元格是文档结构中属于表格的片段。表格将单元格排列为特定的行和列；单元格还可以跨越多个行和列。

单元格通常在将表格插入文档中使用 QTextCursor::insertTable() 时创建，但表格大小调整时也会创建和销毁单元格。

单元格包含它们在表格中的位置信息；您可以获得单元格的 row() 和 column() 编号以及其 rowSpan() 和 columnSpan。

单元格的 format() 函数描述了其内容的默认字符格式。函数 firstCursorPosition() 和 lastCursorPosition() 用于获取单元格在文档中的范围。

另请参阅QTextTable 和 QTextTableFormat。

成员函数文档

QTextTableCell::QTextTableCell()

构建一个无效的表格单元格。

另请参阅isValid。

QTextTableCell::QTextTableCell(const QTextTableCell &other)

复制构造函数。根据 other 单元格创建一个新的 QTextTableCell 对象。

`[noexcept]` QTextTableCell::~QTextTableCell()

销毁表格单元格。

QTextFrame::iterator QTextTableCell::begin() const

返回一个指向表格单元格开始位置的框架迭代器。

另请参阅end。

int QTextTableCell::column() const

返回包含此单元格的表中的列号。

另请参阅row。

int QTextTableCell::columnSpan() const

返回此单元格跨越的列数。默认为 1。

另请参阅rowSpan。

QTextFrame::iterator QTextTableCell::end() const

返回一个指向表格单元格结束位置的框架迭代器。

另请参阅begin。

QTextCursor QTextTableCell::firstCursorPosition() const

返回此单元格中的第一个有效光标位置。

另请参阅lastCursorPosition。

QTextCharFormat QTextTableCell::format() const

返回单元格的字符格式。

另请参阅setFormat。

bool QTextTableCell::isValid() const

如果这是有效的表格单元格，则返回 true；否则返回 false。

QTextCursor QTextTableCell::lastCursorPosition() const

返回此单元格中的最后一个有效光标位置。

另请参阅firstCursorPosition。

int QTextTableCell::row() const

返回包含此单元格的表中的行号。

另请参阅column。

int QTextTableCell::rowSpan() const

返回该单元格跨越的行数。默认为1。

参见columnSpan。

void QTextTableCell::setFormat(const QTextCharFormat &format)

将单元格的字符格式设置为format。例如，可以使用此功能更改整个单元格的背景颜色

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

请注意，不能通过此函数更改单元格的行或列跨度。您必须使用QTextTable::mergeCells和QTextTable::splitCell。

参见format。

int QTextTableCell::tableCellFormatIndex() const

返回单元格格式在文档内部格式列表中的索引。

参见QTextDocument::allFormats。

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

如果此单元格对象和other单元格对象描述了不同的单元格，则返回true；否则返回false。

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

将other单元格分配给此单元格。

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

如果此单元格对象和other单元格对象描述了相同的单元格，则返回true；否则返回false。