Класс QTextFrame

Класс QTextFrame представляет собой фрейм в QTextDocument. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются взаимоисключающими.

Типы публичного доступа

Функции публичного доступа

• 4 функций публичного доступа унаследовано от QTextObject
• 34 функции публичного доступа унаследовано от QObject

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

• 1 свойство унаследовано от QObject
• 1 публичный слот унаследован от QObject
• 2 сигнала унаследовано от QObject
• 1 публичная переменная унаследована от QObject
• 10 статических публичных членов унаследовано от QObject
• 1 защищенная функция унаследована от QTextObject
• 9 защищенных функций унаследовано от QObject
• 2 защищенных переменных унаследовано от QObject

Подробное описание

Класс QTextFrame представляет собой фрейм в QTextDocument.

Фреймы текста обеспечивают структуру для текста в документе. Они используются в качестве универсальных контейнеров для других элементов документа. Фреймы обычно создаются с помощью QTextCursor::insertFrame().

Фреймы можно использовать для создания иерархических структур в документах с форматированным текстом. Каждый документ имеет корневой фрейм (QTextDocument::rootFrame()), и каждый фрейм под корневым фреймом имеет родительский фрейм и (возможно, пустой) список дочерних фреймов. Родительский фрейм можно найти с помощью parentFrame(), а функция childFrames() предоставляет список дочерних фреймов.

Каждый фрейм содержит как минимум один блок текста, чтобы позволить курсорам текста вставлять новые элементы документа внутри. В результате, класс QTextFrame::iterator используется для обхода как блоков, так и дочерних фреймов внутри данного фрейма. Первые и последние дочерние элементы в фрейме можно найти с помощью begin() и end().

Фрейм также имеет формат (заданный с помощью QTextFrameFormat), который может быть задан с помощью setFormat() и прочитан с помощью format().

Можно получить курсоры текста, которые указывают на первые и последние допустимые позиции курсора внутри фрейма; для этого используйте функции firstCursorPosition() и lastCursorPosition(). Охватываемые фреймом области документа можно найти с помощью firstPosition() и lastPosition().

Можно перебрать содержимое фрейма с помощью класса QTextFrame::iterator: это обеспечивает доступ для чтения к его внутреннему списку блоков текста и дочерних фреймов.

См. также QTextCursor и QTextDocument.

Документация по типам членов

typedef QTextFrame::Iterator

Синоним стиля Qt для QTextFrame::iterator.

Документация по функциям членов

QTextFrame::QTextFrame(QTextDocument *document)

Создает новый пустой фрейм для документа document.

[virtual] QTextFrame::~QTextFrame()

Удаляет фрейм текста.

Предупреждение: Фреймы текста принадлежат документу, поэтому вы никогда не должны удалять их сами. Для удаления фрейма из документа удалите его содержимое, используя QTextCursor.

QTextFrame::iterator QTextFrame::begin() const

Возвращает итератор, указывающий на первый элемент документа внутри фрейма. Подробнее см. документ STL-style-Итераторы.

См. также end().

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

Возвращает (возможно, пустой) список дочерних фреймов фрейма.

См. также parentFrame().

QTextFrame::iterator QTextFrame::end() const

Возвращает итератор, указывающий на позицию после последнего элемента документа внутри фрейма. Дополнительная информация содержится в документе Итераторы в стиле STL.

См. также begin().

QTextCursor QTextFrame::firstCursorPosition() const

Возвращает первую позицию курсора внутри фрейма.

См. также lastCursorPosition(), firstPosition() и lastPosition().

int QTextFrame::firstPosition() const

Возвращает первую позицию документа внутри фрейма.

См. также lastPosition(), firstCursorPosition() и lastCursorPosition().

QTextFrameFormat QTextFrame::frameFormat() const

Возвращает формат фрейма.

См. также setFrameFormat().

QTextCursor QTextFrame::lastCursorPosition() const

Возвращает последнюю позицию курсора внутри фрейма.

См. также firstCursorPosition(), firstPosition() и lastPosition().

int QTextFrame::lastPosition() const

Возвращает последнюю позицию документа внутри фрейма.

См. также firstPosition(), firstCursorPosition() и lastCursorPosition().

QTextFrame *QTextFrame::parentFrame() const

Возвращает родительский фрейм фрейма. Если фрейм является корневым фреймом документа, возвращается 0.

См. также childFrames() и QTextDocument::rootFrame().

void QTextFrame::setFrameFormat(const QTextFrameFormat &format)

Устанавливает формат фрейма format.

См. также frameFormat().