Класс 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, используя указанное кодирование (например, "UTF-8", "ISO 8859-1").

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

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

QString QTextDocumentFragment::toPlainText() const

Возвращает текст фрагмента документа как обычный текст (т.е. без информации о форматировании).

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

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

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