Класс QTextListFormat

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

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

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

Типы публичного доступа

Функции публичного доступа

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

Список состоит из одного или нескольких элементов, представленных как текстовые блоки. Формат списка определяет внешний вид элементов в списке. В частности, он определяет отступы и стиль каждого элемента.

Отступ элементов — это целое число, которое смещает каждый элемент от левой границы на определенное количество. Это значение считывается с помощью indent() и устанавливается с помощью setIndent().

Стиль, используемый для оформления каждого элемента, устанавливается с помощью setStyle() и может быть прочитан с помощью функции style(). Стиль определяет тип маркеров и схемы нумерации, используемой для элементов списка. Обратите внимание, что списки, использующие десятичную схему нумерации, начинают счёт с 1, а не с 0.

Свойства стиля могут быть установлены для дальнейшей настройки внешнего вида элементов списка; например, свойства ListNumberPrefix и ListNumberSuffix могут использоваться для настройки чисел, используемых в упорядоченном списке, таким образом, чтобы они отображались как (1), (2), (3) и т. д.:

QTextListFormat listFormat;

listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberPrefix("(");
listFormat.setNumberSuffix(")");

cursor.insertList(listFormat);

См. также QTextList.

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

перечисление QTextListFormat::Style

Это перечисление описывает символы, используемые для оформления элементов списка:

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

QTextListFormat::QTextListFormat()

Конструирует новый объект формата списка.

int QTextListFormat::indent() const

Возвращает отступ формата списка. Отступ умножается на свойство QTextDocument::indentWidth, чтобы получить эффективный отступ в пикселях.

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

bool QTextListFormat::isValid() const

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

QString QTextListFormat::numberPrefix() const

Возвращает префикс нумерации формата списка.

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

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

QString QTextListFormat::numberSuffix() const

Возвращает суффикс нумерации формата списка.

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

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

void QTextListFormat::setIndent(int indentation)

Устанавливает indentation формата списка. Отступ умножается на свойство QTextDocument::indentWidth, чтобы получить эффективный отступ в пикселях.

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

void QTextListFormat::setNumberPrefix(const QString &numberPrefix)

Устанавливает префикс нумерации формата списка в строку, заданную numberPrefix. Это может использоваться со всеми типами упорядоченных списков. Не имеет никакого эффекта для неупорядоченных типов списков.

По умолчанию префикс — пустая строка.

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

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

void QTextListFormat::setNumberSuffix(const QString &numberSuffix)

Устанавливает суффикс нумерации формата списка в строку, заданную numberSuffix. Это может использоваться со всеми типами упорядоченных списков. Не имеет никакого эффекта для неупорядоченных типов списков.

По умолчанию суффикс — ".".

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

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

void QTextListFormat::setStyle(QTextListFormat::Style style)

Устанавливает стиль формата списка style.

См. также style() и Style.

QTextListFormat::Style QTextListFormat::style() const

Возвращает стиль формата списка.

См. также setStyle() и Style.