qt翻译--QTextTable Class Reference（简单表格）

QTextTable Class Reference
[QtGui module]

该类描绘一个表格在 QTextDocument

#include <QTextTable>

继承从 QTextFrame

注意：该类所有函数都是可重入的

公共函数：

void	appendColumns  ( int count )
void	appendRows  ( int count )
QTextTableCell	cellAt  ( int row, int column ) const
QTextTableCell	cellAt  ( int position ) const
QTextTableCell	cellAt  ( const QTextCursor & cursor ) const
int	columns  () const
QTextTableFormat	format  () const
void	insertColumns  ( int index, int columns )
void	insertRows  ( int index, int rows )
void	mergeCells  ( int row, int column, int numRows, int numCols )
void	mergeCells  ( const QTextCursor & cursor )
void	removeColumns  ( int index, int columns )
void	removeRows  ( int index, int rows )
void	resize  ( int rows, int columns )
QTextCursor	rowEnd  ( const QTextCursor & cursor ) const
QTextCursor	rowStart  ( const QTextCursor & cursor ) const
int	rows  () const
void	setFormat  ( const QTextTableFormat & format )
void	splitCell  ( int row, int column, int numRows, int numCols )

 

详细描述：

一个表是一个行列的组合。每一个表包含至少一行和一列。每个单元包含一个块，被一个框架包围。

表通常是使用 QTextCursor::insertTable() 插入。我们能插入一个表用三行两列在目前的光标位置。

QTextCursor cursor(editor->textCursor());
      

     cursor.movePosition(QTextCursor::Start);
      

     QTextTable *table = cursor.insertTable(rows, columns, tableFormat);
      

一个表的格式可以在创建时定义，也可使用 setFormat() 定义。

目前正在编辑的表通常使用 QTextCursor::currentTable （）函数定位。这允许他的格式或者尺度被改变在他已经被插入到一个文件后。

一个表的大小能别改变使用 resize （），或者通过使用 insertRows() ， insertColumns （），

removeRows() ， removeColumns() 。。使用 cellAt() 来找到表格单元。

表格行的开始和结束位置能被找到，通过移动一个光标在一个表内。使用 rowStart() 和 rowEnd() 函数来获得光标位置。

在一个 QTextTable 里的行和列能被合并或者分开，使用 mergeCells （）和 splitCell （）函数。尽管如此，只有那些跨越多行或列的表格能被分开。（合并或者分开不改变行和列的数目）

注意如果你已经合并多行和列变为一个单元。你将不能分开合并的单元变为一个比原来拥有更多行或者列的单元。如果你要分开成更多的单元，你需重复分开操作。

	假设我们有 2*3 的表，合并第一行的两列，我们引用 mergeCells() 当 row  = 0, column = 0, numRows = 1 and numColumns = 2.        table->mergeCells(0, 0, 1, 2);
	得到下面大的表。分开它，我们使用 splitCell() 参数  numRows and numCols = 1.      table->splitCell(0, 0, 1, 1);
	结果 .

成员函数文件：

void QTextTable::appendColumns ( int count )

增加 count 个列在表的右边。

void QTextTable::appendRows ( int count )

QTextTableCell QTextTable::cellAt ( int row, int column ) const

返回指定行列的表格单元

QTextTableCell QTextTable::cellAt ( int position ) const

QTextTableCell QTextTable::cellAt ( const QTextCursor & cursor ) const

int QTextTable::columns () const

QTextTableFormat QTextTable::format () const

返回表格的格式

void QTextTable::insertColumns ( int index, int columns )

在 index 列前，插入 columns 列。

void QTextTable::insertRows ( int index, int rows )

void QTextTable::mergeCells ( int row, int column, int numRows, int numCols )

合并单元在特别的 row 和 colomn 。新的单元将跨越 numRows 行和 numCols 列。如果 numRows 和 numCols 是少于目前单元跨越的行列数，那么这个方法不起作用。

void QTextTable::mergeCells ( const QTextCursor & cursor )

合并被选择的单元

void QTextTable::removeColumns ( int index, int columns )

void QTextTable::removeRows ( int index, int rows )

void QTextTable::resize ( int rows, int columns )

重设表格的大小，已包括要求的行列。

QTextCursor QTextTable::rowEnd ( const QTextCursor & cursor ) const

返回一个光标指向行的结尾。

QTextCursor QTextTable::rowStart ( const QTextCursor & cursor ) const

int QTextTable::rows () const

void QTextTable::setFormat ( const QTextTableFormat & format )

void QTextTable::splitCell ( int row, int column, int numRows, int numCols )

这只适合分开已经跨越多行或列的单元，像是已经被 mergeCells （）合并的单元。