Класс 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::Стиль style)

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

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

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

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

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