Класс QTextOption
Класс QTextOption описывает общие свойства форматированного текста. Подробнее...
| Заголовок: | #include <QTextOption> |
| qmake: | QT += gui |
Примечание: Все функции в этом классе являются повторно-входными.
Открытые типы
| класс | Вкладка |
| перечисление | Флаг { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, AddSpaceForLineAndParagraphSeparators, SuppressColors } |
| флаги | Флаги |
| перечисление | ТипВкладки { LeftTab, RightTab, CenterTab, DelimiterTab } |
| перечисление | РежимОбрезки { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere } |
Открытые функции
| QTextOption() | |
| QTextOption(Qt::Alignment alignment) | |
| QTextOption(const QTextOption &other) | |
| ~QTextOption() | |
| Qt::Alignment | alignment() const |
| QTextOption::Flags | flags() const |
| void | setAlignment(Qt::Alignment alignment) |
| void | setFlags(QTextOption::Flags flags) |
| void | setTabArray(const QList<qreal> &tabStops) |
| void | setTabStopDistance(qreal tabStopDistance) |
| void | setTabs(const QList<QTextOption::Tab> &tabStops) |
| void | setTextDirection(Qt::LayoutDirection direction) |
| void | setUseDesignMetrics(bool enable) |
| void | setWrapMode(QTextOption::WrapMode mode) |
| QList<qreal> | tabArray() const |
| qreal | tabStopDistance() const |
| QList<QTextOption::Tab> | tabs() const |
| Qt::LayoutDirection | textDirection() const |
| bool | useDesignMetrics() const |
| QTextOption::WrapMode | wrapMode() const |
| QTextOption & | operator=(const QTextOption &other) |
Подробное описание
Класс QTextOption описывает общие свойства форматированного текста.
QTextOption используется для объединения общих свойств форматированного текста в один объект. Он содержит информацию об выравнивании текста, направлении компоновки, обрезке слов и других стандартных свойствах, связанных с рендерингом и компоновкой текста.
См. также QTextEdit, QTextDocument и QTextCursor.
Документация типов членов
перечисление QTextOption::Флагфлаги QTextOption::Флаги
| Константа | Значение | Описание |
|---|---|---|
QTextOption::IncludeTrailingSpaces |
0x80000000 |
Когда этот параметр установлен, QTextLine::naturalTextWidth() и naturalTextRect() вернут значение, включающее ширину отступающих пробелов в тексте; в противном случае эта ширина исключается. |
QTextOption::ShowTabsAndSpaces |
0x1 |
Визуализировать пробелы точками, а табуляцию стрелками. Неразрывные пробелы отображаются иначе, чем разрывные пробелы. |
QTextOption::ShowLineAndParagraphSeparators |
0x2 |
Визуализировать разделители строк и абзацев соответствующими символами. |
QTextOption::ShowDocumentTerminator |
0x10 |
Визуализировать конец документа знаком раздела. Это значение перечисления было добавлено в Qt 5.7. |
QTextOption::AddSpaceForLineAndParagraphSeparators |
0x4 |
При определении позиций переноса строки учитывается пространство, добавленное для отображения символа разделителя. |
QTextOption::SuppressColors |
0x8 |
Отключить все изменения цвета в форматах символов (кроме основного выделения). |
Тип Флаги - это псевдоним для QFlags<Флаг>. Он хранит результат побитового ИЛИ комбинации значений Флаг.
перечисление QTextOption::ТипВкладки
Это перечисление содержит различные типы табуляций
| Константа | Значение | Описание |
|---|---|---|
QTextOption::LeftTab |
0 |
Левая табуляция |
QTextOption::RightTab |
1 |
Правая табуляция |
QTextOption::CenterTab |
2 |
Центрированная табуляция |
QTextOption::DelimiterTab |
3 |
Табуляция, останавливающаяся на определенном символе-разделителе |
Это перечисление было введено или изменено в Qt 4.4.
перечисление QTextOption::РежимОбрезки
Это перечисление описывает способ обрезки текста в документе.
| Константа | Значение | Описание |
|---|---|---|
QTextOption::NoWrap |
0 |
Текст не обрезается. |
QTextOption::WordWrap |
1 |
Текст обрезается по границам слов. |
QTextOption::ManualWrap |
2 |
То же, что QTextOption::NoWrap |
QTextOption::WrapAnywhere |
3 |
Текст может быть обрезан в любой точке строки, даже если он находится посреди слова. |
QTextOption::WrapAtWordBoundaryOrAnywhere |
4 |
Если это возможно, обрезка происходит по границе слова; в противном случае она произойдет в соответствующей точке строки, даже посреди слова. |
Документация функций-членов
QTextOption::QTextOption()
Создает объект текстовых параметров со значениями по умолчанию. Свойство выравнивания текста установлено в Qt::AlignLeft. Свойство обрезки слов установлено в QTextOption::WordWrap. Флаг использования метрик дизайна установлен в false.
QTextOption::QTextOption(Qt::Alignment alignment)
Создаёт опцию текста с заданным выравниванием для текста. Свойство перевода слов установлено в QTextOption::WordWrap. Флаг использования метрик дизайна установлен в false.
QTextOption::QTextOption(const QTextOption &other)
Создаёт копию опции текста other.
QTextOption::~QTextOption()
Удаляет опцию текста.
Qt::Alignment QTextOption::alignment() const
Возвращает выравнивание текста, определённое опцией.
См. также setAlignment().
QTextOption::Flags QTextOption::flags() const
Возвращает флаги, связанные с опцией.
См. также setFlags().
void QTextOption::setAlignment(Qt::Alignment alignment)
Устанавливает выравнивание текста опции на указанное alignment.
См. также alignment().
void QTextOption::setFlags(QTextOption::Flags flags)
Устанавливает флаги, связанные с опцией, на заданные flags.
См. также flags().
void QTextOption::setTabArray(const QList<qreal> &tabStops)
Устанавливает позиции табуляции для макета текста на указанные значения tabStops.
См. также tabArray(), setTabStopDistance() и setTabs().
void QTextOption::setTabStopDistance(qreal tabStopDistance)
Устанавливает расстояние по умолчанию в единицах устройства между позициями табуляции на значение, указанное tabStopDistance.
Эта функция была добавлена в Qt 5.10.
См. также tabStopDistance(), setTabArray(), setTabs() и tabs().
void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)
Устанавливает позиции табуляции для макета текста на указанные значения tabStops.
Эта функция была добавлена в Qt 4.4.
void QTextOption::setTextDirection(Qt::LayoutDirection direction)
Устанавливает направление макета текста, определённое опцией, на заданное значение direction.
См. также textDirection().
void QTextOption::setUseDesignMetrics(bool enable)
Если enable равно true, то макет будет использовать метрики дизайна; в противном случае он будет использовать метрики устройства (это стандартное поведение).
См. также useDesignMetrics().
void QTextOption::setWrapMode(QTextOption::WrapMode mode)
Устанавливает режим перевода слов опции на заданный mode.
См. также wrapMode().
QList<qreal> QTextOption::tabArray() const
Возвращает список позиций табуляции, определённых для макета текста.
См. также setTabArray() и tabStop().
qreal QTextOption::tabStopDistance() const
Возвращает расстояние в единицах устройства между позициями табуляции.
Эта функция была добавлена в Qt 5.10.
См. также setTabStopDistance(), tabArray(), setTabs() и tabs().
QList<QTextOption::Tab> QTextOption::tabs() const
Возвращает список позиций табуляции, определённых для макета текста.
Эта функция была добавлена в Qt 4.4.
См. также tabStopDistance(), setTabs() и setTabStop().
Qt::LayoutDirection QTextOption::textDirection() const
Возвращает направление макета текста, определённое опцией.
См. также setTextDirection().
bool QTextOption::useDesignMetrics() const
Возвращает true если макет использует метрики дизайна, а не устройства; в противном случае возвращает false.
См. также setUseDesignMetrics().
QTextOption::WrapMode QTextOption::wrapMode() const
Возвращает режим перевода слов, определённый опцией.
См. также setWrapMode().
QTextOption &QTextOption::operator=(const QTextOption &other)
Возвращает true если опция текста совпадает с опцией текста other; в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qtextoption.html
