Класс QTextListFormat

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

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

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

Общедоступные типы

Общедоступные функции

• 51 общедоступных функций унаследовано от QTextFormat

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

Класс 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

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

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

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

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

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

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

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

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

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

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

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

Задает префикс числа формата списка строкой префикс_числа. Это можно использовать со всеми типами упорядоченных списков. Это не оказывает никакого влияния на неупорядоченные типы списков.

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

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

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

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

Задает суффикс числа формата списка строкой суффикс_числа. Это можно использовать со всеми типами упорядоченных списков. Это не оказывает никакого влияния на неупорядоченные типы списков.

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

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

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

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

Задает стиль формата списка стиль.

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

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

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

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