QTextFrame 类

QTextFrame class represents a frame in a QTextDocument . 更多...

头：	#include <QTextFrame>
qmake:	QT += gui
继承：	QTextObject
继承者：	QTextTable

所有成员列表，包括继承成员

注意： 此类的所有函数可重入 .

公共类型

class	iterator
typedef	Iterator

公共函数

	QTextFrame (QTextDocument * document )
	~QTextFrame ()
iterator	begin () const
QList<QTextFrame *>	childFrames () const
iterator	end () const
QTextCursor	firstCursorPosition () const
int	firstPosition () const
QTextFrameFormat	frameFormat () const
QTextCursor	lastCursorPosition () const
int	lastPosition () const
QTextFrame *	parentFrame () const
void	setFrameFormat (const QTextFrameFormat & format )

4 public functions inherited from QTextObject
32 公共函数继承自 QObject

额外继承成员

1 特性继承自 QObject
1 公共槽继承自 QObject
2 信号继承自 QObject
11 静态公共成员继承自 QObject
1 保护函数继承自 QTextObject
9 保护函数继承自 QObject

详细描述

QTextFrame class represents a frame in a QTextDocument .

Text frames provide structure for the text in a document. They are used as generic containers for other document elements. Frames are usually created by using QTextCursor::insertFrame ().

Frames can be used to create hierarchical structures in rich text documents. Each document has a root frame ( QTextDocument::rootFrame ()), and each frame beneath the root frame has a parent frame and a (possibly empty) list of child frames. The parent frame can be found with parentFrame (), and the childFrames () function provides a list of child frames.

Each frame contains at least one text block to enable text cursors to insert new document elements within. As a result, the QTextFrame::iterator class is used to traverse both the blocks and child frames within a given frame. The first and last child elements in the frame can be found with begin () 和 end ().

A frame also has a format (specified using QTextFrameFormat ) which can be set with setFormat () and read with format ().

Text cursors can be obtained that point to the first and last valid cursor positions within a frame; use the firstCursorPosition () 和 lastCursorPosition () functions for this. The frame's extent in the document can be found with firstPosition () 和 lastPosition ().

You can iterate over a frame's contents using the QTextFrame::iterator class: this provides read-only access to its internal list of text blocks and child frames.

另请参阅 QTextCursor and QTextDocument .

成员类型文档编制

typedef QTextFrame:: Iterator

Qt 样式同义词 QTextFrame::iterator .

成员函数文档编制

QTextFrame:: QTextFrame ( QTextDocument * document )

Creates a new empty frame for the text document .

QTextFrame:: ~QTextFrame ()

Destroys the text frame.

警告： Text frames are owned by the document, so you should never destroy them yourself. In order to remove a frame from its document, remove its contents using a QTextCursor .