Класс QTextFormat
Класс QTextFormat предоставляет информацию о форматировании для QTextDocument. Подробнее...
| Заголовок: | #include <QTextFormat> |
| qmake: | QT += gui |
| Наследуется от: | QTextBlockFormat, QTextCharFormat, QTextFrameFormat и QTextListFormat |
Примечание: Все функции этого класса являются повторно входящими.
Публичные типы
| Перечисление | ТипФорматирования { НеверныйФормат, ФорматБлока, ФорматСимвола, ФорматСписка, ФорматКадра, ПользовательскийФормат } |
| Перечисление | ТипыОбъектов { НетОбъекта, ОбъектИзображения, ОбъектТаблицы, ОбъектЯчейкиТаблицы, ПользовательскийОбъект } |
| Перечисление | ФлагиРазрываСтраницы { РазрывСтраницы_Автоматически, РазрывСтраницы_ВсегдаПеред, РазрывСтраницы_ВсегдаПосле } |
| Флаги | ФлагиРазрываСтраницы |
| Перечисление | Свойство { ИндексОбъекта, CssFloat, НаправлениеРазметки, ОбводкаКонтура, ..., ПользовательскоеСвойство } |
Публичные функции
| QTextFormat() | |
| QTextFormat(int type) | |
| QTextFormat(const QTextFormat &other) | |
| ~QTextFormat() | |
| QBrush | background() const |
| bool | boolProperty(int propertyId) const |
| QBrush | brushProperty(int propertyId) const |
| void | clearBackground() |
| void | clearForeground() |
| void | clearProperty(int propertyId) |
| QColor | colorProperty(int propertyId) const |
| qreal | doubleProperty(int propertyId) const |
| QBrush | foreground() const |
| bool | hasProperty(int propertyId) const |
| int | intProperty(int propertyId) const |
| bool | isBlockFormat() const |
| bool | isCharFormat() const |
| bool | isEmpty() const |
| bool | isFrameFormat() const |
| bool | isImageFormat() const |
| bool | isListFormat() const |
| bool | isTableCellFormat() const |
| bool | isTableFormat() const |
| bool | isValid() const |
| Qt::LayoutDirection | layoutDirection() const |
| QTextLength | lengthProperty(int propertyId) const |
| QVector<QTextLength> | lengthVectorProperty(int propertyId) const |
| void | merge(const QTextFormat &other) |
| int | objectIndex() const |
| int | objectType() const |
| QPen | penProperty(int propertyId) const |
| QMap<int, QVariant> | properties() const |
| QVariant | property(int propertyId) const |
| int | propertyCount() const |
| void | setBackground(const QBrush &brush) |
| void | setForeground(const QBrush &brush) |
| void | setLayoutDirection(Qt::LayoutDirection direction) |
| void | setObjectIndex(int index) |
| void | setObjectType(int type) |
| void | setProperty(int propertyId, const QVariant &value) |
| void | setProperty(int propertyId, const QVector<QTextLength> &value) |
| QString | stringProperty(int propertyId) const |
| void | swap(QTextFormat &other) |
| QTextBlockFormat | toBlockFormat() const |
| QTextCharFormat | toCharFormat() const |
| QTextFrameFormat | toFrameFormat() const |
| QTextImageFormat | toImageFormat() const |
| QTextListFormat | toListFormat() const |
| QTextTableCellFormat | toTableCellFormat() const |
| QTextTableFormat | toTableFormat() const |
| int | type() const |
| QVariant | operator QVariant() const |
| bool | operator!=(const QTextFormat &other) const |
| QTextFormat & | operator=(const QTextFormat &other) |
| bool | operator==(const QTextFormat &other) const |
Статические публичные члены
| const QMetaObject | staticMetaObject |
Подробное описание
Класс QTextFormat предоставляет информацию о форматировании для QTextDocument.
QTextFormat — это общий класс, используемый для описания формата частей QTextDocument. Производные классы QTextCharFormat, QTextBlockFormat, QTextListFormat и QTextTableFormat обычно более полезны и описывают форматирование, которое применяется к определённым частям документа.
Формат имеет FormatType, который определяет виды текстовых элементов, которые он может форматировать; например, блок текста, список, таблица и т. д. Формат также имеет различные свойства (некоторые специфические для определённых типов форматов), как описано в перечислении Property. Каждое свойство имеет соответствующее значение Property.
Тип формата задаётся функцией type(), а проверить формат можно с помощью isCharFormat(), isBlockFormat(), isListFormat(), isTableFormat(), isFrameFormat() и isImageFormat(). Если тип определён, его можно получить с помощью toCharFormat(), toBlockFormat(), toListFormat(), toTableFormat(), toFrameFormat() и toImageFormat().
Свойства формата можно установить с помощью функций setProperty(), а получить с помощью boolProperty(), intProperty(), doubleProperty() и stringProperty() в соответствии с типом свойства. Все идентификаторы свойств, используемых в формате, можно получить с помощью allPropertyIds(). Один формат можно объединить с другим, используя merge().
Индекс объекта формата можно установить с помощью setObjectIndex() и получить с помощью objectIndex(). Эти методы могут быть использованы для ассоциации формата с QTextObject. Они используются для представления списков, фреймов и таблиц внутри документа.
См. также Обработка форматированного текста.
Документация по типам членов
enum QTextFormat::FormatType
Этот перечисление описывает текстовый элемент, который форматирует объект QTextFormat.
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::InvalidFormat |
-1 |
Недействительный формат, созданный конструктором по умолчанию |
QTextFormat::BlockFormat |
1 |
Объект форматирует текстовый блок |
QTextFormat::CharFormat |
2 |
Объект форматирует один символ |
QTextFormat::ListFormat |
3 |
Объект форматирует список |
QTextFormat::FrameFormat |
5 |
Объект форматирует фрейм |
QTextFormat::UserFormat |
100 |
См. также QTextCharFormat, QTextBlockFormat, QTextListFormat, QTextTableFormat и type().
enum QTextFormat::ObjectTypes
Это перечисление описывает тип QTextObject, с которым связан этот формат.
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::NoObject |
0 |
|
QTextFormat::ImageObject |
1 |
|
QTextFormat::TableObject |
2 |
|
QTextFormat::TableCellObject |
3 |
|
QTextFormat::UserObject |
0x1000 |
Первый объект, который можно использовать для задач, специфичных для приложения. |
См. также QTextObject, QTextTable и QTextObject::format().
enum QTextFormat::PageBreakFlagflags QTextFormat::PageBreakFlags
Это перечисление описывает, как выполняется разбиение страниц при печати. Оно соответствует соответствующим свойствам CSS.
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::PageBreak_Auto |
0 |
Разбиение страницы определяется автоматически в зависимости от доступного места на текущей странице |
QTextFormat::PageBreak_AlwaysBefore |
0x001 |
Страница всегда разрывается перед абзацем/таблицей |
QTextFormat::PageBreak_AlwaysAfter |
0x010 |
Новая страница всегда начинается после абзаца/таблицы |
Это перечисление было добавлено или изменено в Qt 4.2.
Тип PageBreakFlags — это псевдоним для QFlags<PageBreakFlag>. Он хранит логическое ИЛИ сочетание значений PageBreakFlag.
См. также QTextBlockFormat::pageBreakPolicy(), QTextFrameFormat::pageBreakPolicy() и PageBreakPolicy.
enum QTextFormat::Property
Это перечисление описывает различные свойства, которые может иметь формат.
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::ObjectIndex |
0x0 |
Индекс форматированного объекта. См. objectIndex(). |
Свойства абзаца и символа
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::CssFloat |
0x0800 |
Как фрейм расположен относительно окружающего текста |
QTextFormat::LayoutDirection |
0x0801 |
Направление вывода текста в документе (Qt::LayoutDirection). |
QTextFormat::OutlinePen |
0x810 |
|
QTextFormat::ForegroundBrush |
0x821 |
|
QTextFormat::BackgroundBrush |
0x820 |
|
QTextFormat::BackgroundImageUrl |
0x823 |
Свойства абзаца
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::BlockAlignment |
0x1010 |
|
QTextFormat::BlockTopMargin |
0x1030 |
|
QTextFormat::BlockBottomMargin |
0x1031 |
|
QTextFormat::BlockLeftMargin |
0x1032 |
|
QTextFormat::BlockRightMargin |
0x1033 |
|
QTextFormat::TextIndent |
0x1034 |
|
QTextFormat::TabPositions |
0x1035 |
Устанавливает позиции табуляции. Позиции табуляции — это структуры QTextOption::Tab, которые хранятся в QList (внутренне, в QList<QVariant>). |
QTextFormat::BlockIndent |
0x1040 |
|
QTextFormat::LineHeight |
0x1048 |
|
QTextFormat::LineHeightType |
0x1049 |
|
QTextFormat::BlockNonBreakableLines |
0x1050 |
|
QTextFormat::BlockTrailingHorizontalRulerWidth |
0x1060 |
Ширина горизонтальной линейки. |
QTextFormat::HeadingLevel |
0x1070 |
Уровень заголовка, например 1 соответствует тегу HTML H1; в противном случае 0. Это значение перечисления было добавлено в Qt 5.12. |
Свойства символа
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::FontFamily |
0x2000 |
|
QTextFormat::FontPointSize |
0x2001 |
|
QTextFormat::FontPixelSize |
0x2009 |
|
QTextFormat::FontSizeAdjustment |
0x2002 |
Указывает изменение размера шрифта, заданного ранее с помощью FontPointSize или FontPixelSize. |
QTextFormat::FontFixedPitch |
0x2008 |
|
QTextFormat::FontWeight |
0x2003 |
|
QTextFormat::FontItalic |
0x2004 |
|
QTextFormat::FontUnderline |
0x2005 |
Этот свойство устарело. Используйте QTextFormat::TextUnderlineStyle вместо него. |
QTextFormat::FontOverline |
0x2006 |
|
QTextFormat::FontStrikeOut |
0x2007 |
|
QTextFormat::FontCapitalization |
FirstFontProperty |
Указывает тип задания прописных букв для текста. |
QTextFormat::FontLetterSpacingType |
0x2033 |
Указывает значение свойства FontLetterSpacing. По умолчанию QFont::PercentageSpacing. |
QTextFormat::FontLetterSpacing |
0x1FE1 |
Изменяет стандартное расстояние между отдельными буквами в шрифте. Значение задаётся в процентах или в абсолютных значениях, в зависимости от FontLetterSpacingType. Значение по умолчанию 100%. |
QTextFormat::FontWordSpacing |
0x1FE2 |
Изменяет стандартное расстояние между отдельными словами. Положительное значение увеличивает интервал между словами на соответствующее количество пикселей; отрицательное значение уменьшает интервал. |
QTextFormat::FontStretch |
0x2034 |
Соответствует свойству QFont::Stretch |
QTextFormat::FontStyleHint |
0x1FE3 |
Соответствует свойству QFont::StyleHint |
QTextFormat::FontStyleStrategy |
0x1FE4 |
Соответствует свойству QFont::StyleStrategy |
QTextFormat::FontKerning |
0x1FE5 |
Указывает, включено ли кернинг в шрифте. |
QTextFormat::FontHintingPreference |
0x1FE6 |
Управляет применением хинтинга в соответствии со значениями перечисления QFont::HintingPreference. |
QTextFormat::TextUnderlineColor |
0x2010 |
|
QTextFormat::TextVerticalAlignment |
0x2021 |
|
QTextFormat::TextOutline |
0x2022 |
|
QTextFormat::TextUnderlineStyle |
0x2023 |
|
QTextFormat::TextToolTip |
0x2024 |
Указывает (необязательный) всплывающую подсказку, отображаемую для фрагмента текста. |
QTextFormat::IsAnchor |
0x2030 |
|
QTextFormat::AnchorHref |
0x2031 |
|
QTextFormat::AnchorName |
0x2032 |
|
QTextFormat::ObjectType |
0x2f00 |
Свойства списков
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::ListStyle |
0x3000 |
Указывает стиль, используемый для элементов списка, описанных значениями перечисления QTextListFormat::Style. |
QTextFormat::ListIndent |
0x3001 |
Указывает отступ, используемый для списка. |
QTextFormat::ListNumberPrefix |
0x3002 |
Определяет текст, добавляемый перед номерами элементов в числовых списках. |
QTextFormat::ListNumberSuffix |
0x3003 |
Определяет текст, добавляемый после номеров элементов в числовых списках. |
Свойства таблиц и фреймов
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::FrameBorder |
0x4000 |
|
QTextFormat::FrameBorderBrush |
0x4009 |
|
QTextFormat::FrameBorderStyle |
0x4010 |
См. перечисление BorderStyle. |
QTextFormat::FrameBottomMargin |
0x4006 |
|
QTextFormat::FrameHeight |
0x4004 |
|
QTextFormat::FrameLeftMargin |
0x4007 |
|
QTextFormat::FrameMargin |
0x4001 |
|
QTextFormat::FramePadding |
0x4002 |
|
QTextFormat::FrameRightMargin |
0x4008 |
|
QTextFormat::FrameTopMargin |
0x4005 |
|
QTextFormat::FrameWidth |
0x4003 |
|
QTextFormat::TableCellSpacing |
0x4102 |
|
QTextFormat::TableCellPadding |
0x4103 |
|
QTextFormat::TableColumns |
0x4100 |
|
QTextFormat::TableColumnWidthConstraints |
0x4101 |
|
QTextFormat::TableHeaderRowCount |
0x4104 |
Свойства ячеек таблицы
| Постоянная | Значение |
|---|---|
QTextFormat::TableCellRowSpan |
0x4810 |
QTextFormat::TableCellColumnSpan |
0x4811 |
QTextFormat::TableCellLeftPadding |
0x4814 |
QTextFormat::TableCellRightPadding |
0x4815 |
QTextFormat::TableCellTopPadding |
0x4812 |
QTextFormat::TableCellBottomPadding |
0x4813 |
Свойства изображений
| Постоянная | Значение |
|---|---|
QTextFormat::ImageName |
0x5000 |
QTextFormat::ImageWidth |
0x5010 |
QTextFormat::ImageHeight |
0x5011 |
QTextFormat::ImageQuality |
0x5014 |
Свойства выделения
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::FullWidthSelection |
0x06000 |
При установке на characterFormat выделенного фрагмента, вся ширина текста будет отображаться выделенной. |
Свойства разрыва страницы
| Постоянная | Значение | Описание |
|---|---|---|
QTextFormat::PageBreakPolicy |
0x7000 |
Определяет, как разделяются страницы. См. перечисление PageBreakFlag. |
QTextFormat::UserProperty |
0x100000 |
См. также property() и setProperty().
Документация функций-членов
QTextFormat::QTextFormat()
Создаёт новый формат текста с InvalidFormat.
См. также FormatType.
QTextFormat::QTextFormat(int type)
Создаёт новый формат текста заданного типа type.
См. также FormatType.
QTextFormat::QTextFormat(const QTextFormat &other)
Создаёт новый формат текста с такими же атрибутами, что и у формата текста other.
QTextFormat::~QTextFormat()
Уничтожает этот формат текста.
QBrush QTextFormat::background() const
Возвращает кисть, используемую для отрисовки фона документа.
См. также setBackground(), clearBackground(), и foreground().
bool QTextFormat::boolProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId. Если свойство не является типом QTextFormat::Bool, возвращается false.
См. также setProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), и Property.
QBrush QTextFormat::brushProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId. Если свойство не является типом QVariant::Brush, возвращается Qt::NoBrush.
См. также setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty(), и Property.
void QTextFormat::clearBackground()
Очищает кисть, используемую для отрисовки фона документа. Будет использоваться кисть по умолчанию.
См. также background(), setBackground(), и clearForeground().
void QTextFormat::clearForeground()
Очищает кисть, используемую для отрисовки переднего плана документа. Будет использоваться кисть по умолчанию.
См. также foreground(), setForeground(), и clearBackground().
void QTextFormat::clearProperty(int propertyId)
Очищает значение свойства, заданного propertyId.
См. также Property.
QColor QTextFormat::colorProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId. Если свойство не является типом QVariant::Color, возвращается недопустимый цвет.
См. также setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty(), и Property.
qreal QTextFormat::doubleProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId. Если свойство не является типом QVariant::Double или QMetaType::Float, возвращается 0.
См. также setProperty(), boolProperty(), intProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), и Property.
QBrush QTextFormat::foreground() const
Возвращает кисть, используемую для отрисовки элементов переднего плана, таких как текст, контуры рамок и границы таблиц.
См. также setForeground(), clearForeground(), и background().
bool QTextFormat::hasProperty(int propertyId) const
Возвращает true, если формат текста содержит свойство с заданным propertyId; в противном случае возвращает false.
См. также properties() и Property.
int QTextFormat::intProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId. Если свойство не является типом QTextFormat::Integer, возвращается 0.
См. также setProperty(), boolProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), и Property.
bool QTextFormat::isBlockFormat() const
Возвращает true, если этот формат текста является блочным форматом; в противном случае возвращает false.
bool QTextFormat::isCharFormat() const
Возвращает true, если этот формат текста является форматом символа; в противном случае возвращает false.
bool QTextFormat::isEmpty() const
Возвращает true, если формат не содержит свойств; в противном случае возвращает false.
Эта функция была добавлена в Qt 5.3.
См. также propertyCount() и properties().
bool QTextFormat::isFrameFormat() const
Возвращает true, если этот формат текста является форматом рамки; в противном случае возвращает false.
bool QTextFormat::isImageFormat() const
Возвращает true, если этот формат текста является форматом изображения; в противном случае возвращает false.
bool QTextFormat::isListFormat() const
Возвращает true, если этот формат текста является форматом списка; в противном случае возвращает false.
bool QTextFormat::isTableCellFormat() const
Возвращает true, если этот формат текста является форматом ячейки таблицы; в противном случае возвращает false.
Эта функция была добавлена в Qt 4.4.
bool QTextFormat::isTableFormat() const
Возвращает true, если этот формат текста является форматом таблицы; в противном случае возвращает false.
bool QTextFormat::isValid() const
Возвращает true, если формат действителен (т.е. не InvalidFormat); в противном случае возвращает false.
Qt::LayoutDirection QTextFormat::layoutDirection() const
Возвращает направление отображения документа.
См. также setLayoutDirection().
QTextLength QTextFormat::lengthProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId.
См. также setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthVectorProperty() и Property.
QVector<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId. Если свойство не является типом QTextFormat::LengthVector, возвращается пустой вектор длин.
См. также setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty() и Property.
void QTextFormat::merge(const QTextFormat &other)
Объединяет формат other с этим форматом; при конфликтах формат other имеет приоритет.
int QTextFormat::objectIndex() const
Возвращает индекс объекта формата или -1, если объект формата недействителен.
См. также setObjectIndex().
int QTextFormat::objectType() const
Возвращает тип объекта формата текста.
См. также ObjectTypes и setObjectType().
QPen QTextFormat::penProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId; если свойство не является типом QVariant::Pen, возвращается Qt::NoPen.
См. также setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() и Property.
QMap<int, QVariant> QTextFormat::properties() const
Возвращает карту со всеми свойствами этого формата текста.
QVariant QTextFormat::property(int propertyId) const
Возвращает свойство, заданное данным propertyId.
См. также setProperty() и Property.
int QTextFormat::propertyCount() const
Возвращает количество свойств, хранящихся в формате.
Эта функция была добавлена в Qt 4.3.
void QTextFormat::setBackground(const QBrush &brush)
Устанавливает кисть для рисования фона документа на заданную brush.
См. также background(), clearBackground() и setForeground().
void QTextFormat::setForeground(const QBrush &brush)
Устанавливает кисть переднего плана на указанную brush. Кисть переднего плана в основном используется для отображения текста.
См. также foreground(), clearForeground() и setBackground().
void QTextFormat::setLayoutDirection(Qt::LayoutDirection direction)
Устанавливает направление макета документа на указанное direction.
См. также layoutDirection().
void QTextFormat::setObjectIndex(int index)
Устанавливает индекс объекта формата на index.
См. также objectIndex().
void QTextFormat::setObjectType(int type)
Устанавливает тип объекта формата текста на type.
См. также ObjectTypes и objectType().
void QTextFormat::setProperty(int propertyId, const QVariant &value)
Устанавливает свойство, заданное propertyId, на указанное value.
См. также property() и Property.
void QTextFormat::setProperty(int propertyId, const QVector<QTextLength> &value)
Устанавливает значение свойства, заданного propertyId, на value.
См. также lengthVectorProperty() и Property.
QString QTextFormat::stringProperty(int propertyId) const
Возвращает значение свойства, заданного propertyId; если свойство не является типом QVariant::String, возвращается пустая строка.
См. также setProperty(), boolProperty(), intProperty(), doubleProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() и Property.
void QTextFormat::swap(QTextFormat &other)
Меняет местами этот формат текста с other. Эта функция очень быстрая и никогда не завершается ошибкой.
Эта функция была добавлена в Qt 5.0.
QTextBlockFormat QTextFormat::toBlockFormat() const
Возвращает этот формат как формат блока.
QTextCharFormat QTextFormat::toCharFormat() const
Возвращает этот формат как формат символов.
QTextFrameFormat QTextFormat::toFrameFormat() const
Возвращает этот формат как формат фрейма.
QTextImageFormat QTextFormat::toImageFormat() const
Возвращает этот формат как формат изображения.
QTextListFormat QTextFormat::toListFormat() const
Возвращает этот формат как формат списка.
QTextTableCellFormat QTextFormat::toTableCellFormat() const
Возвращает этот формат как формат ячейки таблицы.
Эта функция была добавлена в Qt 4.4.
QTextTableFormat QTextFormat::toTableFormat() const
Возвращает этот формат как формат таблицы.
int QTextFormat::type() const
Возвращает тип этого формата.
См. также FormatType.
QVariant QTextFormat::operator QVariant() const
Возвращает формат текста как QVariant.
bool QTextFormat::operator!=(const QTextFormat &other) const
Возвращает true если этот формат текста отличается от формата текста other.
QTextFormat &QTextFormat::operator=(const QTextFormat &other)
Присваивает формат текста other этому формату текста и возвращает ссылку на этот формат текста.
bool QTextFormat::operator==(const QTextFormat &other) const
Возвращает true если этот формат текста совпадает с форматом текста other.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qtextformat.html
