Класс QTextDocument
Класс QTextDocument хранит форматированный текст. Подробнее...
| Заголовок: | #include <QTextDocument> |
| qmake: | QT += gui |
| Наследует: | QObject |
Примечание: Все функции в этом классе являются реентерабельными.
Типы публичного доступа
| перечисление | FindFlag { FindBackward, FindCaseSensitively, FindWholeWords } |
| флаги | FindFlags |
| перечисление | MetaInformation { DocumentTitle, DocumentUrl } |
| перечисление | ResourceType { HtmlResource, ImageResource, StyleSheetResource, UserResource } |
| перечисление | Stacks { UndoStack, RedoStack, UndoAndRedoStacks } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Публичные функции
| QTextDocument(QObject *parent = nullptr) | |
| QTextDocument(const QString &text, QObject *parent = nullptr) | |
| virtual | ~QTextDocument() |
| void | addResource(int type, const QUrl &name, const QVariant &resource) |
| void | adjustSize() |
| QVector<QTextFormat> | allFormats() const |
| int | availableRedoSteps() const |
| int | availableUndoSteps() const |
| QUrl | baseUrl() const |
| QTextBlock | begin() const |
| int | blockCount() const |
| QChar | characterAt(int pos) const |
| int | characterCount() const |
| virtual void | clear() |
| void | clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks) |
| QTextDocument * | clone(QObject *parent = nullptr) const |
| Qt::CursorMoveStyle | defaultCursorMoveStyle() const |
| QFont | defaultFont() const |
| QString | defaultStyleSheet() const |
| QTextOption | defaultTextOption() const |
| QAbstractTextDocumentLayout * | documentLayout() const |
| qreal | documentMargin() const |
| void | drawContents(QPainter *p, const QRectF &rect = QRectF()) |
| QTextBlock | end() const |
| QTextCursor | find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = ...) const |
| QTextCursor | find(const QString &subString, int position = 0, QTextDocument::FindFlags options = ...) const |
| QTextCursor | find(const QRegExp &expr, int from = 0, QTextDocument::FindFlags options = ...) const |
| QTextCursor | find(const QRegExp &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = ...) const |
| QTextCursor | find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = ...) const |
| QTextCursor | find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = ...) const |
| QTextBlock | findBlock(int pos) const |
| QTextBlock | findBlockByLineNumber(int lineNumber) const |
| QTextBlock | findBlockByNumber(int blockNumber) const |
| QTextBlock | firstBlock() const |
| qreal | idealWidth() const |
| qreal | indentWidth() const |
| bool | isEmpty() const |
| bool | isModified() const |
| bool | isRedoAvailable() const |
| bool | isUndoAvailable() const |
| bool | isUndoRedoEnabled() const |
| QTextBlock | lastBlock() const |
| int | lineCount() const |
| void | markContentsDirty(int position, int length) |
| int | maximumBlockCount() const |
| QString | metaInformation(QTextDocument::MetaInformation info) const |
| QTextObject * | object(int objectIndex) const |
| QTextObject * | objectForFormat(const QTextFormat &f) const |
| int | pageCount() const |
| QSizeF | pageSize() const |
| void | print(QPagedPaintDevice *printer) const |
| void | redo(QTextCursor *cursor) |
| QVariant | resource(int type, const QUrl &name) const |
| int | revision() const |
| QTextFrame * | rootFrame() const |
| void | setBaseUrl(const QUrl &url) |
| void | setDefaultCursorMoveStyle(Qt::CursorMoveStyle style) |
| void | setDefaultFont(const QFont &font) |
| void | setDefaultStyleSheet(const QString &sheet) |
| void | setDefaultTextOption(const QTextOption &option) |
| void | setDocumentLayout(QAbstractTextDocumentLayout *layout) |
| void | setDocumentMargin(qreal margin) |
| void | setHtml(const QString &html) |
| void | setIndentWidth(qreal width) |
| void | setMaximumBlockCount(int maximum) |
| void | setMetaInformation(QTextDocument::MetaInformation info, const QString &string) |
| void | setPageSize(const QSizeF &size) |
| void | setPlainText(const QString &text) |
| void | setTextWidth(qreal width) |
| void | setUndoRedoEnabled(bool enable) |
| void | setUseDesignMetrics(bool b) |
| QSizeF | size() const |
| qreal | textWidth() const |
| QString | toHtml(const QByteArray &encoding = QByteArray()) const |
| QString | toPlainText() const |
| QString | toRawText() const |
| void | undo(QTextCursor *cursor) |
| bool | useDesignMetrics() const |
- 31 public functions inherited from QObject
Public Slots
| void | redo() |
| void | setModified(bool m = true) |
| void | undo() |
- 1 public slot inherited from QObject
Сигналы
| void | baseUrlChanged(const QUrl &url) |
| void | blockCountChanged(int newBlockCount) |
| void | contentsChange(int position, int charsRemoved, int charsAdded) |
| void | contentsChanged() |
| void | cursorPositionChanged(const QTextCursor &cursor) |
| void | documentLayoutChanged() |
| void | modificationChanged(bool changed) |
| void | redoAvailable(bool available) |
| void | undoAvailable(bool available) |
| void | undoCommandAdded() |
- 2 signals inherited from QObject
Статические публичные члены
| const QMetaObject | staticMetaObject |
- 9 static public members inherited from QObject
Защищенные функции
| virtual QTextObject * | createObject(const QTextFormat &format) |
| virtual QVariant | loadResource(int type, const QUrl &name) |
- 9 protected functions inherited from QObject
Подробное описание
Класс QTextDocument хранит форматированный текст.
QTextDocument — это контейнер для структурированных документов с форматированным текстом, поддерживающий стилизованный текст и различные типы элементов документа, такие как списки, таблицы, фреймы и изображения. Их можно использовать в QTextEdit или независимо.
Каждый элемент документа описывается связанным объектом формата. Каждый объект формата обрабатывается QTextDocuments как уникальный объект и может быть передан objectForFormat() для получения элемента документа, к которому он применяется.
QTextDocument можно редактировать программно с помощью QTextCursor, а его содержимое можно просматривать, проходя по структуре документа. Вся структура документа хранится в виде иерархии элементов документа под корневым фреймом, который можно получить с помощью функции rootFrame(). В качестве альтернативы, если вы хотите просто перебирать текстовое содержимое документа, вы можете использовать begin(), end() и findBlock() для извлечения текстовых блоков, которые вы можете исследовать и перебирать.
Макет документа определяется documentLayout(); вы можете создать свой подкласс QAbstractTextDocumentLayout и установить его с помощью setDocumentLayout(), если хотите использовать собственную логику макета. Заголовок документа и другие метаданные можно получить, вызвав функцию metaInformation(). Для документов, которые отображаются пользователю через класс QTextEdit, заголовок документа также доступен через функцию QTextEdit::documentTitle().
Функции toPlainText() и toHtml() позволяют получить содержимое документа в виде простого текста и HTML. Поиск текста в документе можно выполнить с помощью функций find().
Обработку операций отмены/повторного выполнения, выполненных над документом, можно контролировать с помощью функции setUndoRedoEnabled(). Систему отмены/повторного выполнения можно контролировать с помощью редактора-виджета с помощью слотов undo() и redo(); документ также предоставляет сигналы contentsChanged(), undoAvailable() и redoAvailable(), которые информируют подключенные виджеты-редакторы о состоянии системы отмены/повторного выполнения. Следующие действия являются операциями отмены/повторного выполнения QTextDocument:
- Вставка или удаление символов. Последовательность вставок или удалений в пределах одного текстового блока рассматривается как одна операция отмены/повторного выполнения.
- Вставка или удаление текстовых блоков. Последовательности вставок или удалений в одной операции (например, при выделении и удалении текста) рассматриваются как одна операция отмены/повторного выполнения.
- Изменение формата символов текста.
- Изменение формата текстовых блоков.
- Изменение формата группы текстовых блоков.
См. также QTextCursor, QTextEdit, Обработка форматированного текста и Пример объекта текста.
Документация по типам членов
enum QTextDocument::FindFlagфлаги QTextDocument::FindFlags
Этот перечисление описывает опции, доступные для функции поиска QTextDocument. Опции могут быть объединены с помощью оператора ИЛИ из следующего списка:
| Константа | Значение | Описание |
|---|---|---|
QTextDocument::FindBackward |
0x00001 |
Поиск в обратном направлении вместо прямого. |
QTextDocument::FindCaseSensitively |
0x00002 |
По умолчанию поиск не учитывает регистр. Указание этой опции изменяет поведение на поиск, учитывающий регистр. |
QTextDocument::FindWholeWords |
0x00004 |
Выполняет поиск только целых слов. |
Тип FindFlags является типом-синонимом для QFlags<FindFlag>. Он хранит объединённые значения FindFlag с помощью оператора ИЛИ.
enum QTextDocument::MetaInformation
Это перечисление описывает различные типы метаданных, которые можно добавить в документ.
| Константа | Значение | Описание |
|---|---|---|
QTextDocument::DocumentTitle |
0 |
Название документа. |
QTextDocument::DocumentUrl |
1 |
URL документа. Функция loadResource() использует этот URL в качестве базового при загрузке относительных ресурсов. |
См. также metaInformation() и setMetaInformation().
enum QTextDocument::ResourceType
Это перечисление описывает типы ресурсов, которые можно загрузить с помощью функции QTextDocument's loadResource().
| Константа | Значение | Описание |
|---|---|---|
QTextDocument::HtmlResource |
1 |
Ресурс содержит HTML. |
QTextDocument::ImageResource |
2 |
Ресурс содержит данные изображения. В настоящее время поддерживаются типы данных QVariant::Pixmap и QVariant::Image. Если соответствующий вариант имеет тип QVariant::ByteArray, Qt пытается загрузить изображение с помощью QImage::loadFromData. QVariant::Icon в настоящее время не поддерживается. Иконка должна быть преобразована в один из поддерживаемых типов, например, с помощью QIcon::pixmap. |
QTextDocument::StyleSheetResource |
3 |
Ресурс содержит CSS. |
QTextDocument::UserResource |
100 |
Первое доступное значение для пользовательских типов ресурсов. |
См. также loadResource().
enum QTextDocument::Stacks
| Константа | Значение | Описание |
|---|---|---|
QTextDocument::UndoStack |
0x01 |
Стек отмены. |
QTextDocument::RedoStack |
0x02 |
Стек повторения. |
QTextDocument::UndoAndRedoStacks |
UndoStack | RedoStack |
Оба стека: отмены и повторения. |
Документация свойств
baseUrl : QUrl
Это свойство содержит базовый URL, используемый для разрешения относительных URL-адресов ресурсов в документе.
URL-адреса ресурсов разрешаются в той же директории, что и целевой базовый URL, что означает, что любая часть пути после последнего '/' будет проигнорирована.
| Базовый URL | Относительный URL | Разрешенный URL |
|---|---|---|
| file:///path/to/content | images/logo.png | file:///path/to/images/logo.png |
| file:///path/to/content/ | images/logo.png | file:///path/to/content/images/logo.png |
| file:///path/to/content/index.html | images/logo.png | file:///path/to/content/images/logo.png |
| file:///path/to/content/images/ | ../images/logo.png | file:///path/to/content/images/logo.png |
Это свойство было добавлено в Qt 5.3.
Функции доступа:
| QUrl | baseUrl() const |
| void | setBaseUrl(const QUrl &url) |
Сигнал уведомления:
| void | baseUrlChanged(const QUrl &url) |
blockCount : const int
Возвращает количество текстовых блоков в документе.
Значение этого свойства не определено в документах с таблицами или кадрами.
По умолчанию, если определено, это свойство содержит значение 1.
Это свойство было добавлено в Qt 4.2.
Функции доступа:
| int | blockCount() const |
См. также lineCount() и characterCount().
defaultFont : QFont
Это свойство содержит шрифт по умолчанию, используемый для отображения текста документа.
Функции доступа:
| QFont | defaultFont() const |
| void | setDefaultFont(const QFont &font) |
defaultStyleSheet : QString
Стиль по умолчанию применяется ко всему новому HTML-форматированному тексту, который вставляется в документ, например, с помощью setHtml() или QTextCursor::insertHtml().
Стиль должен соответствовать синтаксису CSS 2.1.
Примечание: Изменение стиля по умолчанию не влияет на существующее содержимое документа.
Это свойство было добавлено в Qt 4.2.
Функции доступа:
| QString | defaultStyleSheet() const |
| void | setDefaultStyleSheet(const QString &sheet) |
См. также Поддержка HTML-подмножества.
defaultTextOption : QTextOption
Это свойство содержит опцию текста по умолчанию, которая будет установлена для всех QTextLayout в документе.
Когда создаются QTextBlocks, defaultTextOption устанавливается на их QTextLayout. Это позволяет устанавливать глобальные свойства для документа, такие как режим перевода слов по умолчанию.
Функции доступа:
| QTextOption | defaultTextOption() const |
| void | setDefaultTextOption(const QTextOption &option) |
documentMargin : qreal
Отступ вокруг документа. По умолчанию 4.
Это свойство было добавлено в Qt 4.5.
Функции доступа:
| qreal | documentMargin() const |
| void | setDocumentMargin(qreal margin) |
indentWidth : qreal
Возвращает ширину, используемую для отступов списков и блоков текста.
Свойства отступа QTextListFormat и QTextBlockFormat задают кратные этому значению. По умолчанию ширина отступа равна 40.
Это свойство было добавлено в Qt 4.4.
Функции доступа:
| qreal | indentWidth() const |
| void | setIndentWidth(qreal width) |
maximumBlockCount : int
Устанавливает предел для блоков в документе.
Устанавливает максимальное количество блоков, которое может содержать документ. Если в документе больше блоков, чем указано в этом свойстве, блоки удаляются с начала документа.
Отрицательное или нулевое значение указывает, что документ может содержать неограниченное количество блоков.
Значение по умолчанию равно 0.
Обратите внимание, что установка этого свойства немедленно применит ограничение к содержимому документа.
Установка этого свойства также отключает историю отмены-повтор.
Это свойство не определено в документах с таблицами или кадрами.
Это свойство было добавлено в Qt 4.2.
Функции доступа:
| int | maximumBlockCount() const |
| void | setMaximumBlockCount(int maximum) |
modified : bool
Это свойство указывает, был ли документ изменён пользователем.
По умолчанию, это свойство равно false.
Функции доступа:
| bool | isModified() const |
| void | setModified(bool m = true) |
См. также modificationChanged().
pageSize : QSizeF
Это свойство содержит размер страницы, который должен использоваться для вывода документа.
Единицы определяются базовым устройством отрисовки. Размер измеряется в логических пикселях при отрисовке на экран и в пунктах (1/72 дюйма) при отрисовке на принтере.
По умолчанию, для вновь созданного пустого документа, это свойство содержит неопределённый размер.
Функции доступа:
| QSizeF | pageSize() const |
| void | setPageSize(const QSizeF &size) |
См. также modificationChanged().
size : const QSizeF
Возвращает фактический размер документа. Это эквивалентно documentLayout()->documentSize();
Размер документа можно изменить, установив ширину текста или размер всей страницы.
Обратите внимание, что ширина всегда >= pageSize().width().
По умолчанию, для вновь созданного пустого документа, это свойство содержит размер, зависящий от конфигурации.
Это свойство было добавлено в Qt 4.2.
Функции доступа:
| QSizeF | size() const |
См. также setTextWidth(), setPageSize(), и idealWidth().
textWidth : qreal
Ширина текста задает предпочтительную ширину текста в документе. Если текст (или содержимое в целом) шире указанной, он разбивается на несколько строк и увеличивается по вертикали. Если текст нельзя разбить на несколько строк для размещения в указанной ширине текста, он будет больше, а свойства size() и idealWidth() отразят это.
Если ширина текста установлена в -1, то текст не будет разбиваться на несколько строк, если это не принудительно не сделано с помощью явного разрыва строки или нового абзаца.
Значение по умолчанию — -1.
Установка ширины текста также установит высоту страницы в -1, что приведет к вертикальному изменению размера документа непрерывным образом. Если вы хотите, чтобы макет документа разбивал текст на несколько страниц, то необходимо установить свойство pageSize вместо этого.
Это свойство было введено в Qt 4.2.
Функции доступа:
| qreal | textWidth() const |
| void | setTextWidth(qreal width) |
См. также size(), idealWidth() и pageSize().
undoRedoEnabled : bool
Это свойство указывает, включены ли отмена/повтор для данного документа.
По умолчанию оно равно true. Если отключено, стек отмены очищается, и никакие элементы в него не добавляются.
Функции доступа:
| bool | isUndoRedoEnabled() const |
| void | setUndoRedoEnabled(bool enable) |
useDesignMetrics : bool
Это свойство указывает, использует ли документ метрики дизайна шрифтов для повышения точности вывода текста.
Если это свойство установлено в true, для вывода будет использоваться метрики дизайна. В противном случае будут использоваться метрики устройства отрисовки, установленные в QAbstractTextDocumentLayout::setPaintDevice().
Использование меток дизайна означает, что ширина вывода больше не зависит от намеков и округления пикселей. Это означает, что WYSIWYG-вывод текста становится возможным, потому что ширина масштабируется гораздо линейнее, основываясь на метриках устройства отрисовки, чем в противном случае.
По умолчанию это свойство равно false.
Это свойство было введено в Qt 4.1.
Функции доступа:
| bool | useDesignMetrics() const |
| void | setUseDesignMetrics(bool b) |
Документация по членам-функциям
QTextDocument::QTextDocument(QObject *parent = nullptr)
Создаёт пустой QTextDocument с заданным parent.
QTextDocument::QTextDocument(const QString &text, QObject *parent = nullptr)
Создаёт QTextDocument, содержащий указанный простой (неформатированный) текст text, с заданным parent.
[virtual] QTextDocument::~QTextDocument()
Удаляет документ.
void QTextDocument::addResource(int type, const QUrl &name, const QVariant &resource)
Добавляет ресурс resource в кэш ресурсов, используя type и name в качестве идентификаторов. type должен быть значением из QTextDocument::ResourceType.
Например, вы можете добавить изображение как ресурс для его ссылки в документе:
document->addResource(QTextDocument::ImageResource,
QUrl("mydata://image.png"), QVariant(image)); Изображение можно вставить в документ, используя API QTextCursor:
QTextImageFormat imageFormat;
imageFormat.setName("mydata://image.png");
cursor.insertImage(imageFormat); В качестве альтернативы, вы можете вставить изображения, используя HTML-тег img.
editor->append("<img src=\"mydata://image.png\" />"); void QTextDocument::adjustSize()
Настраивает размер документа на приемлемое значение.
Эта функция была введена в Qt 4.2.
См. также idealWidth(), textWidth и size.
QVector<QTextFormat> QTextDocument::allFormats() const
Возвращает вектор текстовых форматов для всех форматов, используемых в документе.
int QTextDocument::availableRedoSteps() const
Возвращает количество доступных шагов отмены.
Эта функция была введена в Qt 4.6.
См. также isRedoAvailable().
int QTextDocument::availableUndoSteps() const
Возвращает количество доступных шагов отмены.
Эта функция была введена в Qt 4.6.
См. также isUndoAvailable().
QTextBlock QTextDocument::begin() const
Возвращает первый блок текста документа.
См. также firstBlock().
[signal] void QTextDocument::blockCountChanged(int newBlockCount)
Этот сигнал генерируется при изменении общего количества блоков текста в документе. Переданное значение newBlockCount — новое общее количество.
Эта функция была введена в Qt 4.3.
QChar QTextDocument::characterAt(int pos) const
Возвращает символ в позиции pos или нулевой символ, если позиция находится вне диапазона.
Эта функция была введена в Qt 4.5.
См. также characterCount().
int QTextDocument::characterCount() const
Возвращает количество символов в этом документе.
Эта функция была введена в Qt 4.5.
См. также blockCount() и characterAt().
[virtual] void QTextDocument::clear()
Очищает документ.
void QTextDocument::clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks)
Очищает стеки, указанные в stacksToClear.
Этот метод очищает все команды в стеке отмены, стеке повтора или обоих (по умолчанию). Если команды очищены, генерируются соответствующие сигналы, QTextDocument::undoAvailable() или QTextDocument::redoAvailable().
Эта функция была введена в Qt 4.7.
См. также QTextDocument::undoAvailable() и QTextDocument::redoAvailable().
QTextDocument *QTextDocument::clone(QObject *parent = nullptr) const
Создаёт новый QTextDocument, который является копией этого текстового документа. parent — родитель возвращаемого текстового документа.
[signal] void QTextDocument::contentsChange(int position, int charsRemoved, int charsAdded)
Этот сигнал генерируется всякий раз, когда изменяется содержимое документа; например, при вставке или удалении текста или применении форматирования.
Предоставляется информация о позиции символа в документе, где произошло изменение (position), количестве удалённых символов (charsRemoved) и количестве добавленных символов (charsAdded).
Сигнал генерируется до того, как менеджер вывода документа уведомит о изменении. Этот обработчик позволяет вам реализовать подсветку синтаксиса для документа.
См. также QAbstractTextDocumentLayout::documentChanged() и contentsChanged().
[signal] void QTextDocument::contentsChanged()
Этот сигнал генерируется всякий раз, когда изменяется содержимое документа; например, при вставке или удалении текста или применении форматирования.
См. также contentsChange().
[virtual protected] QTextObject *QTextDocument::createObject(const QTextFormat &format)
Создаёт и возвращает новый объект документа (объект QTextObject), основанный на заданном format.
QTextObjects всегда создаются через этот метод, поэтому вам необходимо переопределить его, если вы используете пользовательские текстовые объекты внутри вашего документа.
[signal] void QTextDocument::cursorPositionChanged(const QTextCursor &cursor)
Этот сигнал генерируется всякий раз, когда меняется позиция курсора из-за операции редактирования. Курсор, который изменился, передаётся в cursor. Если документ используется с классом QTextEdit, и вам нужен сигнал при перемещении курсора клавишами со стрелками, вы можете использовать сигнал cursorPositionChanged() в QTextEdit.
Qt::CursorMoveStyle QTextDocument::defaultCursorMoveStyle() const
Стиль перемещения курсора по умолчанию используется всеми объектами QTextCursor, созданными из документа. По умолчанию используется Qt::LogicalMoveStyle.
Эта функция была введена в Qt 4.8.
См. также setDefaultCursorMoveStyle().
QFont QTextDocument::defaultFont() const
Возвращает шрифт по умолчанию, используемый в макете документа.
Примечание: Функция-геттер для свойства defaultFont.
См. также setDefaultFont().
QTextOption QTextDocument::defaultTextOption() const
Параметры текста по умолчанию используются для всех объектов QTextLayout в документе. Это позволяет устанавливать глобальные свойства документа, такие как режим перевода слов по умолчанию.
Эта функция была введена в Qt 4.3.
Примечание: Функция-геттер для свойства defaultTextOption.
См. также setDefaultTextOption().
QAbstractTextDocumentLayout *QTextDocument::documentLayout() const
Возвращает макет документа для этого документа.
См. также setDocumentLayout().
[signal] void QTextDocument::documentLayoutChanged()
Этот сигнал испускается при установке нового макета документа.
Эта функция была введена в Qt 4.4.
См. также setDocumentLayout().
void QTextDocument::drawContents(QPainter *p, const QRectF &rect = QRectF())
Отображает содержимое документа с помощью объекта рисования p, ограниченного прямоугольником rect. Если rect — пустой прямоугольник (значение по умолчанию), документ отрисовывается без ограничений.
Эта функция была введена в Qt 4.2.
QTextBlock QTextDocument::end() const
Эта функция возвращает блок для проверки конца документа при итерации по нему.
for (QTextBlock it = doc->begin(); it != doc->end(); it = it.next())
cout << it.text().toStdString() << endl; Возвращаемый блок недопустимый и представляет собой блок после последнего блока в документе. Вы можете использовать lastBlock() для получения последнего действительного блока документа.
См. также lastBlock().
QTextCursor QTextDocument::find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = ...) const
Ищет следующее вхождение строки subString в документе. Поиск начинается с позиции заданного курсора cursor и продолжается вперед по документу, если не указано иное в параметрах поиска. Параметр options управляет типом выполняемого поиска.
Возвращает курсор с выделенным совпадением, если subString найдена; в противном случае возвращает пустой курсор.
Если у заданного cursor есть выделение, поиск начинается после выделения; в противном случае он начинается с позиции курсора.
По умолчанию поиск не учитывает регистр и может находить совпадения в любом месте документа.
QTextCursor QTextDocument::find(const QString &subString, int position = 0, QTextDocument::FindFlags options = ...) const
Это перегруженная функция.
Ищет следующее вхождение строки subString в документе. Поиск начинается с заданной позиции position и продолжается вперед по документу, если не указано иное в параметрах поиска. Параметр options управляет типом выполняемого поиска.
Возвращает курсор с выделенным совпадением, если subString найдена; в противном случае возвращает пустой курсор.
Если position равно 0 (значение по умолчанию), поиск начинается с начала документа; в противном случае он начинается с указанной позиции.
QTextCursor QTextDocument::find(const QRegExp &expr, int from = 0, QTextDocument::FindFlags options = ...) const
Это перегруженная функция.
Ищет следующее вхождение, соответствующее заданному регулярному выражению expr, в том же абзаце документа.
Поиск начинается с заданной позиции from и продолжается вперед по документу, если не указано иное в параметрах поиска. Параметр options управляет типом выполняемого поиска. Опция FindCaseSensitively игнорируется для этой перегрузки, используйте QRegExp::caseSensitivity вместо этого.
Возвращает курсор с выделенным совпадением, если совпадение найдено; в противном случае возвращает пустой курсор.
Если позиция from равна 0 (значение по умолчанию), поиск начинается с начала документа; в противном случае он начинается с указанной позиции.
QTextCursor QTextDocument::find(const QRegExp &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = ...) const
Это перегруженная функция.
Ищет следующее вхождение, соответствующее заданному регулярному выражению expr, в том же абзаце документа.
Поиск начинается с позиции заданного курсора cursor и продолжается вперед по документу, если не указано иное в параметрах поиска. Параметр options управляет типом выполняемого поиска. Опция FindCaseSensitively игнорируется для этой перегрузки, используйте QRegExp::caseSensitivity вместо этого.
Возвращает курсор с выделенным совпадением, если совпадение найдено; в противном случае возвращает пустой курсор.
Если у заданного cursor есть выделение, поиск начинается после выделения; в противном случае он начинается с позиции курсора.
По умолчанию поиск не учитывает регистр и может находить совпадения в любом месте документа.
QTextCursor QTextDocument::find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = ...) const
Ищет следующее вхождение, соответствующее заданному регулярному выражению expr, в том же абзаце документа.
Поиск начинается с заданной позиции from и продолжается вперед по документу, если не указано иное в параметрах поиска. Параметр options управляет типом выполняемого поиска.
Возвращает курсор с выделенным совпадением, если совпадение найдено; в противном случае возвращает пустой курсор.
Если позиция from равна 0 (значение по умолчанию), поиск начинается с начала документа; в противном случае он начинается с указанной позиции.
Эта функция была введена в Qt 5.5.
QTextCursor QTextDocument::find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = ...) const
Ищет следующее вхождение, соответствующее заданному регулярному выражению expr, в том же абзаце документа.
Поиск начинается с позиции заданного курсора cursor и продолжается вперед по документу, если не указано иное в параметрах поиска. Параметр options управляет типом выполняемого поиска.
Возвращает курсор с выделенным совпадением, если совпадение найдено; в противном случае возвращает пустой курсор.
Если у заданного cursor есть выделение, поиск начинается после выделения; в противном случае он начинается с позиции курсора.
По умолчанию поиск не учитывает регистр и может находить совпадения в любом месте документа.
Эта функция была введена в Qt 5.5.
QTextBlock QTextDocument::findBlock(int pos) const
Возвращает абзац текста, содержащий символ с номером pos.
QTextBlock QTextDocument::findBlockByLineNumber(int lineNumber) const
Возвращает абзац текста, содержащий указанную строку lineNumber.
Эта функция была введена в Qt 4.5.
См. также QTextBlock::firstLineNumber().
QTextBlock QTextDocument::findBlockByNumber(int blockNumber) const
Возвращает абзац текста с указанным номером blockNumber.
Эта функция была введена в Qt 4.4.
См. также QTextBlock::blockNumber().
QTextBlock QTextDocument::firstBlock() const
Возвращает первый абзац текста документа.
Эта функция была введена в Qt 4.4.
qreal QTextDocument::idealWidth() const
Возвращает идеальную ширину документа. Идеальная ширина — это фактически используемая ширина документа без учета дополнительных выравниваний. Она всегда меньше или равна size().width().
Эта функция была добавлена в Qt 4.2.
См. также adjustSize() и textWidth.
bool QTextDocument::isEmpty() const
Возвращает true если документ пуст; в противном случае возвращает false.
bool QTextDocument::isRedoAvailable() const
Возвращает true если повторное выполнение доступно; в противном случае возвращает false.
См. также isUndoAvailable() и availableRedoSteps().
bool QTextDocument::isUndoAvailable() const
Возвращает true если отмена доступна; в противном случае возвращает false.
См. также isRedoAvailable() и availableUndoSteps().
QTextBlock QTextDocument::lastBlock() const
Возвращает последний (действительный) блок текста документа.
Эта функция была добавлена в Qt 4.4.
int QTextDocument::lineCount() const
Возвращает количество строк в этом документе (если макет поддерживает это). В противном случае, это идентично количеству блоков.
Эта функция была добавлена в Qt 4.5.
См. также blockCount() и characterCount().
[virtual protected] QVariant QTextDocument::loadResource(int type, const QUrl &name)
Загружает данные указанного типа type из ресурса с заданным именем name.
Эта функция вызывается движком форматирования rich text для запроса данных, которые не хранятся напрямую в QTextDocument, но все равно связаны с ним. Например, изображения косвенно ссылаются на атрибут имени объекта QTextImageFormat.
При вызове Qt, type — одно из значений перечисления QTextDocument::ResourceType.
Если QTextDocument является дочерним объектом QObject, который имеет вызываемый метод loadResource, такой как QTextEdit, QTextBrowser или сам QTextDocument, то реализация по умолчанию пытается извлечь данные из родительского объекта.
Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.
void QTextDocument::markContentsDirty(int position, int length)
Помечает содержимое, заданное заданным position и length, как «изменённое», уведомляя документ о необходимости повторного вычисления макета.
QString QTextDocument::metaInformation(QTextDocument::MetaInformation info) const
Возвращает метаинформацию о документе указанного типа info.
См. также setMetaInformation().
[signal] void QTextDocument::modificationChanged(bool changed)
Этот сигнал испускается всякий раз, когда содержимое документа изменяется таким образом, что это влияет на состояние модификации. Если changed равно true, документ был изменён; в противном случае — false.
Например, вызов setModified(false) для документа, а затем вставка текста приводит к испусканию сигнала. Если вы отменяете эту операцию, возвращая документ в его исходное неизменённое состояние, сигнал будет испущен снова.
QTextObject *QTextDocument::object(int objectIndex) const
Возвращает текстовый объект, связанный с заданным objectIndex.
QTextObject *QTextDocument::objectForFormat(const QTextFormat &f) const
Возвращает текстовый объект, связанный с форматом f.
int QTextDocument::pageCount() const
Возвращает количество страниц в этом документе.
void QTextDocument::print(QPagedPaintDevice *printer) const
Печатает документ на указанном printer. QPagedPaintDevice должен быть настроен перед использованием с этой функцией.
Это просто метод для удобства печати всего документа на принтер.
Если документ уже разбит на страницы в соответствии с заданной высотой в свойстве pageSize(), он печатается как есть.
Если документ не разбит на страницы, например, документ, используемый в QTextEdit, создаётся временная копия документа, и копия разбивается на несколько страниц в соответствии с размером свойства paperRect() устройства рисования. По умолчанию вокруг содержимого документа устанавливается отступ 2 см. Кроме того, на каждой странице печатается текущий номер страницы внизу.
См. также QTextEdit::print().
void QTextDocument::redo(QTextCursor *cursor)
Повторяет последнюю операцию редактирования документа, если повторное выполнение доступно.
Предоставленный cursor размещается в конце позиции, где операция редактирования была повторена.
Эта функция была добавлена в Qt 4.2.
[slot] void QTextDocument::redo()
Это перегруженная функция.
Повторяет последнюю операцию редактирования документа, если повторное выполнение доступно.
[signal] void QTextDocument::redoAvailable(bool available)
Этот сигнал испускается всякий раз, когда операции повторного выполнения становятся доступны (available равно true) или недоступны (available равно false).
QVariant QTextDocument::resource(int type, const QUrl &name) const
Возвращает данные указанного типа type из ресурса с заданным именем name.
Эта функция вызывается движком форматирования rich text для запроса данных, которые не хранятся напрямую в QTextDocument, но все равно связаны с ним. Например, изображения косвенно ссылаются на атрибут имени объекта QTextImageFormat.
Ресурсы кэшируются внутри документа. Если ресурс не найден в кэше, вызывается loadResource для попытки загрузки ресурса. loadResource должен использовать addResource для добавления ресурса в кэш.
См. также QTextDocument::ResourceType.
int QTextDocument::revision() const
Возвращает версию документа (если включена отмена).
Гарантируется, что версия увеличится, когда документ, который не изменён, будет отредактирован.
Эта функция была добавлена в Qt 4.4.
См. также QTextBlock::revision() и isModified().
QTextFrame *QTextDocument::rootFrame() const
Возвращает корневой фрейм документа.
void QTextDocument::setDefaultCursorMoveStyle(Qt::CursorMoveStyle style)
Устанавливает стиль перемещения курсора по умолчанию в заданный style.
Эта функция была добавлена в Qt 4.8.
См. также defaultCursorMoveStyle().
void QTextDocument::setDefaultFont(const QFont &font)
Устанавливает шрифт по умолчанию для использования в макете документа.
Примечание: Функция-сеттер для свойства defaultFont.
См. также defaultFont().
void QTextDocument::setDefaultTextOption(const QTextOption &option)
Устанавливает опцию текста по умолчанию в option.
Эта функция была добавлена в Qt 4.3.
Примечание: Функция-сеттер для свойства defaultTextOption.
См. также defaultTextOption().
void QTextDocument::setDocumentLayout(QAbstractTextDocumentLayout *layout)
Устанавливает документ для использования заданного макета layout. Предыдущий макет удаляется.
См. также documentLayoutChanged().
void QTextDocument::setHtml(const QString &html)
Заменяет всё содержимое документа заданным HTML-форматированным текстом в строке html. История отмены/повторного выполнения сбрасывается при вызове этой функции.
HTML-форматирование учитывается по возможности; например, «<b>жирный</b> текст» создаст текст, где у первого слова будет набранный жирным шрифтом вид: «жирный текст».
Примечание: Звонящий обязан убедиться, что текст правильно декодирован при создании QString, содержащего HTML, и передаче его в setHtml().
См. также setPlainText() и Поддерживаемый подмножество HTML.
void QTextDocument::setIndentWidth(qreal width)
Устанавливает ширину, используемую для отступа списков и блоков текста.
Свойства отступа QTextListFormat и QTextBlockFormat указывают кратные этому значению. Значение по умолчанию для ширины отступа составляет 40.
Эта функция была добавлена в Qt 4.4.
Примечание: Функция-сеттер для свойства indentWidth.
См. также indentWidth().
void QTextDocument::setMetaInformation(QTextDocument::MetaInformation info, const QString &string)
Устанавливает метаинформацию документа типа, указанного в info, на заданную строку.
См. также metaInformation().
void QTextDocument::setPlainText(const QString &text)
Заменяет все содержимое документа заданным простым текстом. История отмены/повтора сбрасывается при вызове этой функции.
См. также setHtml().
QString QTextDocument::toHtml(const QByteArray &encoding = QByteArray()) const
Возвращает строку, содержащую представление документа в формате HTML.
Параметр encoding определяет значение атрибута charset в заголовке html. Например, если указан 'utf-8', то начало сгенерированного html будет выглядеть так:
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body>...
Если кодировка не указана, такая метаинформация не генерируется.
Если впоследствии вы преобразуете возвращенную строку html в массив байтов для передачи по сети или сохранения на диск, вы должны указать кодировку, которую вы будете использовать для преобразования в массив байтов здесь.
См. также Поддерживаемый подмножество HTML.
QString QTextDocument::toPlainText() const
Возвращает текстовое представление документа без форматирования. Если вам нужна информация о форматировании, используйте QTextCursor вместо этого.
Эта функция возвращает то же, что и toRawText(), но заменяет некоторые символы Юникода на ASCII-аналоги. В частности, неразрывный пробел (U+00A0) заменяется обычным пробелом (U+0020), а разделители абзаца (U+2029) и строки (U+2028) заменяются символом новой строки (U+000A). Если вам требуется точное содержимое документа, используйте toRawText().
Примечание: Встроенные объекты, такие как изображения, представлены значением Юникода U+FFFC (СИМВОЛ ЗАМЕНЫ ОБЪЕКТА).
См. также toHtml().
QString QTextDocument::toRawText() const
Возвращает исходный текст, содержащийся в документе, без какой-либо информации о форматировании. Если вам нужна информация о форматировании, используйте QTextCursor вместо этого.
Эта функция была добавлена в Qt 5.9.
См. также toPlainText().
void QTextDocument::undo(QTextCursor *cursor)
Отменяет последнее действие редактирования в документе, если отмена доступна. Предоставленный курсор размещается в конце расположения, где было отменено действие редактирования.
См. документацию по Qt Undo Framework для получения подробностей.
Эта функция была добавлена в Qt 4.2.
См. также undoAvailable() и isUndoRedoEnabled().
[slot] void QTextDocument::undo()
Это перегруженная функция.
[signal] void QTextDocument::undoAvailable(bool available)
Этот сигнал излучается всякий раз, когда операции отмены становятся доступными (available имеет значение true) или недоступными (available имеет значение false).
См. документацию по Qt Undo Framework для получения подробностей.
См. также undo() и isUndoRedoEnabled().
[signal] void QTextDocument::undoCommandAdded()
Этот сигнал излучается каждый раз, когда к QTextDocument добавляется новый уровень отмены.
Эта функция была добавлена в Qt 4.4.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qtextdocument.html