Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QTextFrame Class Reference
^{[модуль QtGui ]}

The QTextFrame class represents a frame in a QTextDocument. Далее...

 #include <QTextFrame>

Inherits QTextObject.

Inherited by 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
• 29 открытых функций, унаследованных от QObject

[править] Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 1 сигнал, унаследованный от QObject
• 5 статических открытых членов, унаследованных от QObject
• 1 protected function inherited from QTextObject
• 7 защищенных функций, унаследованных от QObject

[править] Подробное описание

The 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() and 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() and lastCursorPosition() functions for this. The frame's extent in the document can be found with firstPosition() and 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.

See also QTextCursor and QTextDocument.

[править] Описание типов

[править]

typedef QTextFrame::Iterator

Qt-style synonym for QTextFrame::iterator.

[править] Описание функций-членов

[править]

QTextFrame::QTextFrame ( QTextDocument * document )

Creates a new empty frame for the text document.

[править]

QTextFrame::~QTextFrame ()

Destroys the frame, and removes it from the document's layout.

[править]

iterator QTextFrame::begin () const

Returns an iterator pointing to the first document element inside the frame.

See also end().

[править]

QList<QTextFrame *> QTextFrame::childFrames () const

Returns a (possibly empty) list of the frame's child frames.

See also parentFrame().

[править]

iterator QTextFrame::end () const

Returns an iterator pointing to the last document element inside the frame.

See also begin().

[править]

QTextCursor QTextFrame::firstCursorPosition () const

Returns the first cursor position inside the frame.

See also lastCursorPosition(), firstPosition(), and lastPosition().

[править]

int QTextFrame::firstPosition () const

Returns the first document position inside the frame.

See also lastPosition(), firstCursorPosition(), and lastCursorPosition().

[править]

QTextFrameFormat QTextFrame::frameFormat () const

Returns the frame's format.

See also setFrameFormat().

[править]

QTextCursor QTextFrame::lastCursorPosition () const

Returns the last cursor position inside the frame.

See also firstCursorPosition(), firstPosition(), and lastPosition().

[править]

int QTextFrame::lastPosition () const

Returns the last document position inside the frame.

See also firstPosition(), firstCursorPosition(), and lastCursorPosition().

[править]

QTextFrame * QTextFrame::parentFrame () const

Returns the frame's parent frame. If the frame is the root frame of a document, this will return 0.

See also childFrames() and QTextDocument::rootFrame().

[править]

void QTextFrame::setFrameFormat ( const QTextFrameFormat & format )

Sets the frame's format.

See also frameFormat().