Класс QTextOption

Класс QTextOption предоставляет описание общих свойств форматированного текста. Подробнее...

Заголовок:	#include <QTextOption>
CMake:	find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui

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

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

Открытые типы

Структура	Tab
Перечисление	Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, AddSpaceForLineAndParagraphSeparators, SuppressColors }
Флаги	Flags
Перечисление	TabType { LeftTab, RightTab, CenterTab, DelimiterTab }
Перечисление	WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere }

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

	QTextOption(const QTextOption &other)
	QTextOption(Qt::Alignment alignment)
	QTextOption()
QTextOption &	operator=(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 используется для объединения общих свойств форматированного текста в один объект. Он содержит информацию об выравнивании текста, направлении макета, обёртывании слов и других стандартных свойствах, связанных с рендерингом и макетом текста.

См. также QTextEdit, QTextDocument и QTextCursor.

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

Перечисление QTextOption::FlagФлаги QTextOption::Flags

Константа	Значение	Описание
`QTextOption::IncludeTrailingSpaces`	`0x80000000`	Когда этот параметр установлен, QTextLine::naturalTextWidth() и naturalTextRect() вернут значение, которое включает ширину отступающих пробелов в тексте; в противном случае эта ширина исключается.
`QTextOption::ShowTabsAndSpaces`	`0x1`	Визуализирует пробелы небольшими точками, а табуляции – маленькими стрелками. Неразрывные пробелы отображаются по-другому, чем разрывные пробелы.
`QTextOption::ShowLineAndParagraphSeparators`	`0x2`	Визуализирует разделители строк и абзацев соответствующими символами.
`QTextOption::ShowDocumentTerminator`	`0x10`	Визуализирует конец документа знаком раздела. Это значение перечисления было добавлено в Qt 5.7.
`QTextOption::AddSpaceForLineAndParagraphSeparators`	`0x4`	При определении позиций разбиения строк учитывается пространство, добавленное для рисования символа разделителя.
`QTextOption::SuppressColors`	`0x8`	Подавляет все изменения цвета в форматах символов (кроме основного выделения).

Тип Flags является типом-синонимом для QFlags<Flag>. Он хранит логическое ИЛИ сочетание значений Flag.

Перечисление QTextOption::TabType

Это перечисление содержит различные типы табуляции

Константа	Значение	Описание
`QTextOption::LeftTab`	`0`	Левая табуляция
`QTextOption::RightTab`	`1`	Правая табуляция
`QTextOption::CenterTab`	`2`	Центрированная табуляция
`QTextOption::DelimiterTab`	`3`	Табуляция, останавливающаяся на определенном разделительном символе

Перечисление QTextOption::WrapMode

Это перечисление описывает, как текст обёртывается в документе.

Константа	Значение	Описание
`QTextOption::NoWrap`	`0`	Текст вообще не обёртывается.
`QTextOption::WordWrap`	`1`	Текст обёртывается по границам слов.
`QTextOption::ManualWrap`	`2`	То же, что QTextOption::NoWrap
`QTextOption::WrapAnywhere`	`3`	Текст может быть обёрнут в любой точке строки, даже если он встречается посреди слова.
`QTextOption::WrapAtWordBoundaryOrAnywhere`	`4`	Если возможно, обёртывание происходит по границе слова; в противном случае оно произойдёт в соответствующей точке строки, даже посреди слова.

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

QTextOption::QTextOption(const QTextOption &other)

Создаёт копию текстового параметра other.

QTextOption::QTextOption(Qt::Alignment alignment)

Создаёт текстовый параметр с заданным выравниванием alignment для текста. Свойство обёртывания слов установлено в QTextOption::WordWrap. Флаг использования метрик дизайна установлен в false.

QTextOption::QTextOption()

Создаёт опцию текста с параметрами по умолчанию для текста. Параметр выравнивания текста установлен в Qt::AlignLeft. Параметр перевода слов установлен в QTextOption::WordWrap. Флаг использования метрик дизайна установлен в false.

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

Возвращает true если опция текста такая же, как опция текста other; в противном случае возвращает false.

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().

`[since 5.10]` void QTextOption::setTabStopDistance(qreal tabStopDistance)

Устанавливает расстояние по умолчанию в единицах устройства между табуляциями на значение, заданное tabStopDistance.

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

См. также tabStopDistance(), setTabArray(), setTabs(), и tabs().

void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)

Устанавливает позиции табуляции для форматирования текста на значения, указанные в tabStops.

См. также tabs() и tabStopDistance().

void QTextOption::setTextDirection(Qt::LayoutDirection direction)

Устанавливает направление форматирования текста, определённое опцией, на заданное значение direction.

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

void QTextOption::setUseDesignMetrics(bool enable)

Если enable истинно, то форматирование будет использовать метрики дизайна; в противном случае оно будет использовать метрики устройства (по умолчанию).

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

void QTextOption::setWrapMode(QTextOption::WrapMode mode)

Устанавливает режим перевода слов опции на заданное значение mode.

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

QList<qreal> QTextOption::tabArray() const

Возвращает список позиций табуляции, определённых для форматирования текста.

См. также setTabArray() и tabStopDistance().

`[since 5.10]` qreal QTextOption::tabStopDistance() const

Возвращает расстояние в единицах устройства между табуляциями.

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

См. также setTabStopDistance(), tabArray(), setTabs(), и tabs().

QList<QTextOption::Tab> QTextOption::tabs() const