Класс QTextListFormat

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

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

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

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

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

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

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

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

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

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

QTextListFormat listFormat;

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

cursor.insertList(listFormat);

См. также QTextList.

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

Перечисление QTextListFormat::Стиль

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

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

QTextListFormat::QTextListFormat()

Создает новый объект формата списка.

int QTextListFormat::отступ() const

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

См. также установитьОтступ().

bool QTextListFormat::isValid() const

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

QString QTextListFormat::префиксЧисла() const

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

См. также установитьПрефиксЧисла().

QString QTextListFormat::суффиксЧисла() const

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

См. также установитьСуффиксЧисла().

void QTextListFormat::установитьОтступ(int отступ)

Устанавливает отступ формата списка. Отступ умножается на свойство QTextDocument::indentWidth для получения эффективного отступа в пикселях.

См. также отступ().

void QTextListFormat::установитьПрефиксЧисла(const QString &префиксЧисла)

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

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

См. также префиксЧисла().

void QTextListFormat::установитьСуффиксЧисла(const QString &суффиксЧисла)

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

По умолчанию суффикс — это «.».

См. также суффиксЧисла().

void QTextListFormat::установитьСтиль(QTextListFormat::Стиль стиль)

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

См. также стиль() и Стиль.

QTextListFormat::Стиль QTextListFormat::стиль() const

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

См. также установитьСтиль() и Стиль.