Класс QTextDocumentFragment

Класс QTextDocumentFragment представляет собой фрагмент форматированного текста из QTextDocument. Подробнее...

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

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

Открытые функции

Статические открытые члены

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

Класс QTextDocumentFragment представляет собой фрагмент форматированного текста из QTextDocument.

Объект QTextDocumentFragment — это фрагмент форматированного текста, который можно вставить в QTextDocument. Фрагмент документа может быть создан из QTextDocument, из выделенного текста QTextCursor или из другого фрагмента документа. Фрагменты документов также могут быть созданы статическими функциями fromPlainText() и fromHtml().

Содержимое фрагмента документа может быть получено в виде простого текста с помощью функции toPlainText() или в виде HTML с помощью toHtml().

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

QTextDocumentFragment::QTextDocumentFragment()

Создаёт пустой QTextDocumentFragment.

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

QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)

Преобразует данный document в QTextDocumentFragment. Обратите внимание, что QTextDocumentFragment хранит только содержимое документа, а не метаданные, такие как заголовок документа.

QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)

Создаёт QTextDocumentFragment из выделенного текста cursor. Если у курсора нет выделения, создаваемый фрагмент пуст.

См. также isEmpty() и QTextCursor::selection().

QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)

Конструктор копирования. Создаёт копию фрагмента other.

QTextDocumentFragment::~QTextDocumentFragment()

Удаляет фрагмент документа.

[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text)

Возвращает QTextDocumentFragment на основе произвольного фрагмента HTML в заданном text. Форматирование сохраняется по возможности; например, "<b>жирный</b>" станет фрагментом документа с текстом "жирный" и жирным шрифтом.

[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider)

Возвращает QTextDocumentFragment на основе произвольного фрагмента HTML в заданном text. Форматирование сохраняется по возможности; например, "<b>жирный</b>" станет фрагментом документа с текстом "жирный" и жирным шрифтом.

Если предоставленный HTML содержит ссылки на внешние ресурсы, такие как импортированные таблицы стилей, они будут загружаться через resourceProvider.

Эта функция была добавлена в Qt 4.2.

[static] QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)

Возвращает фрагмент документа, содержащий заданный plainText.

При вставке такого фрагмента в QTextDocument используется текущий формат символов QTextCursor, используемый для вставки, в качестве формата текста.

bool QTextDocumentFragment::isEmpty() const

Возвращает true , если фрагмент пуст; в противном случае возвращает false.

QString QTextDocumentFragment::toHtml(const QByteArray &encoding = QByteArray()) const

Возвращает содержимое фрагмента документа в формате HTML, используя указанное encoding (например, "UTF-8", "ISO 8859-1").

Эта функция была добавлена в Qt 4.2.

См. также toPlainText(), QTextDocument::toHtml() и QTextCodec.

QString QTextDocumentFragment::toPlainText() const

Возвращает текст фрагмента документа в виде простого текста (т.е. без форматирования).

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

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

Присваивает фрагмент other этому фрагменту.