Класс QTextBlockFormat

Класс QTextBlockFormat предоставляет информацию о форматировании блоков текста в QTextDocument. Подробнее...

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

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

Типы

Публичные функции

• 51 публичная функция унаследована от QTextFormat

Подробное описание

Класс QTextBlockFormat предоставляет информацию о форматировании блоков текста в QTextDocument.

Документ состоит из списка блоков, представленных объектами QTextBlock. Каждый блок может содержать какой-либо элемент, например, абзац текста, таблицу, список или изображение. Каждый блок имеет связанный QTextBlockFormat, который определяет его характеристики.

Для поддержки языков слева направо и справа налево можно установить направление блока с помощью setDirection(). Выравнивание абзаца устанавливается с помощью setAlignment(). Отступы контролируются setTopMargin(), setBottomMargin(), setLeftMargin(), setRightMargin(). Общий отступ устанавливается с помощью setIndent(), отступ первой строки — с помощью setTextIndent().

Межстрочный интервал устанавливается с помощью setLineHeight() и извлекается с помощью lineHeight() и lineHeightType(). Типы межстрочных интервалов доступны в перечислении LineHeightTypes.

Разрыв строки можно включить и выключить с помощью setNonBreakableLines().

Щётка, используемая для рисования фона абзаца, устанавливается с помощью setBackground(), а другие аспекты внешнего вида текста можно настроить, используя функцию setProperty() со значениями перечисления QTextFormat::Property OutlinePen, ForegroundBrush, и BackgroundBrush.

Если блок текста является частью списка, он также может иметь формат списка, доступный с помощью функции listFormat().

См. также QTextBlock и QTextCharFormat.

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

Перечисление QTextBlockFormat::LineHeightTypes

Это перечисление описывает различные типы поддержки межстрочного интервала, которые могут иметь абзацы.

Это перечисление было введено или изменено в Qt 4.8.

См. также lineHeight(), lineHeightType(), и setLineHeight().

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

QTextBlockFormat::QTextBlockFormat()

Создаёт новый QTextBlockFormat.

Qt::Alignment QTextBlockFormat::alignment() const

Возвращает выравнивание абзаца.

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

qreal QTextBlockFormat::bottomMargin() const

Возвращает нижний отступ абзаца.

См. также setBottomMargin() и topMargin().

int QTextBlockFormat::indent() const

Возвращает отступ абзаца.

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

bool QTextBlockFormat::isValid() const

Возвращает true , если этот формат блока действителен; в противном случае возвращает false.

qreal QTextBlockFormat::leftMargin() const

Возвращает левую отступ абзаца.

См. также setLeftMargin(), rightMargin() и indent().

qreal QTextBlockFormat::lineHeight(qreal scriptLineHeight, qreal scaling) const

Возвращает высоту строк в абзаце, исходя из высоты строки скрипта, заданной параметром scriptLineHeight, и заданного коэффициента масштабирования scaling.

Возвращаемое значение также зависит от заданного типа высоты строки (LineHeightType) абзаца, а также от настройки высоты строки (LineHeight), установленной для абзаца.

Масштабирование требуется для высот, включающих фиксированное количество пикселей, для их соответствующего масштабирования при печати.

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

См. также LineHeightTypes, setLineHeight() и lineHeightType().

qreal QTextBlockFormat::lineHeight() const

Возвращает свойство LineHeight для абзаца.

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

См. также LineHeightTypes, setLineHeight() и lineHeightType().

int QTextBlockFormat::lineHeightType() const

Возвращает свойство LineHeightType абзаца.

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

См. также LineHeightTypes, setLineHeight() и lineHeight().

bool QTextBlockFormat::nonBreakableLines() const

Возвращает true если строки в абзаце неразрывны; в противном случае возвращает false.

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

PageBreakFlags QTextBlockFormat::pageBreakPolicy() const

Возвращает текущую политику разрыва страницы для абзаца. По умолчанию — QTextFormat::PageBreak_Auto.

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

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

qreal QTextBlockFormat::rightMargin() const

Возвращает правый отступ абзаца.

См. также setRightMargin() и leftMargin().

void QTextBlockFormat::setAlignment(Qt::Alignment alignment)

Устанавливает выравнивание абзаца по alignment.

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

void QTextBlockFormat::setBottomMargin(qreal margin)

Устанавливает нижний отступ абзаца по margin.

См. также bottomMargin(), setTopMargin(), setLeftMargin() и setRightMargin().

void QTextBlockFormat::setIndent(int indentation)

Устанавливает отступ абзаца по indentation. Отступы задаются независимо от отступа с помощью setLeftMargin() и setTextIndent(). indentation — целое число, умножаемое на стандартный отступ документа, что приводит к фактическому отступу абзаца.

См. также indent() и QTextDocument::indentWidth().

void QTextBlockFormat::setLeftMargin(qreal margin)

Устанавливает левый отступ абзаца по margin. Отступ можно применять отдельно с помощью setIndent().

См. также leftMargin(), setRightMargin(), setTopMargin() и setBottomMargin().

void QTextBlockFormat::setLineHeight(qreal height, int heightType)

Устанавливает высоту строки абзаца в значение height, которое зависит от heightType так, как описано в перечислении LineHeightTypes.

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

См. также LineHeightTypes, lineHeight() и lineHeightType().

void QTextBlockFormat::setNonBreakableLines(bool b)

Если b равно true, строки в абзаце обрабатываются как неразрывные; в противном случае они разрывны.

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

void QTextBlockFormat::setPageBreakPolicy(PageBreakFlags policy)

Устанавливает политику разрыва страницы для абзаца на policy.

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

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

void QTextBlockFormat::setRightMargin(qreal margin)

Устанавливает правый отступ абзаца по margin.

См. также rightMargin(), setLeftMargin(), setTopMargin() и setBottomMargin().

void QTextBlockFormat::setTabPositions(const QList<QTextOption::Tab> &tabs)

Устанавливает позиции табуляции для текстового блока на те, которые указаны в tabs.

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

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

void QTextBlockFormat::setTextIndent(qreal indent)

Устанавливает отступ первой строки блока по indent. Это позволяет отступать первую строку абзаца по-другому, чем другие строки, улучшая удобочитаемость текста.

См. также textIndent(), setLeftMargin(), setRightMargin(), setTopMargin() и setBottomMargin().

void QTextBlockFormat::setTopMargin(qreal margin)

Устанавливает верхний отступ абзаца по margin.

См. также topMargin(), setBottomMargin(), setLeftMargin() и setRightMargin().

QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const

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

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

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

qreal QTextBlockFormat::textIndent() const

Возвращает отступ первой строки абзаца.

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

qreal QTextBlockFormat::topMargin() const

Возвращает верхний отступ абзаца.

См. также setTopMargin() и bottomMargin().