Класс QTextList

Класс QTextList предоставляет форматированный список элементов в QTextDocument. Подробнее...

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

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

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

• 4 открытые функции унаследованные от QTextObject
• 34 открытые функции унаследованные от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 1 открытая переменная, унаследованная от QObject
• 10 статические открытые члены, унаследованные от QObject
• 4 защищенных функции, унаследованные от QTextBlockGroup
• 1 защищенная функция, унаследованная от QTextObject
• 9 защищенных функций, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QObject

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

Класс QTextList предоставляет форматированный список элементов в QTextDocument.

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

Списки создаются с помощью курсора текста для вставки пустого списка в текущей позиции или перемещением существующего текста в новый список. Функция QTextCursor::insertList() вставляет пустой блок в документ в позиции курсора и делает его первым элементом списка.

    QTextListFormat listFormat;
    if (list) {
        listFormat = list->format();
        listFormat.setIndent(listFormat.indent() + 1);
    }

    listFormat.setStyle(QTextListFormat::ListDisc);
    cursor.insertList(listFormat);

Функция QTextCursor::createList() принимает содержимое текущего блока курсора и преобразует его в первый элемент нового списка.

Текущий список курсора находится с помощью QTextCursor::currentList().

Количество элементов в списке задаётся функцией count(). Каждый элемент можно получить по его индексу в списке с помощью функции item(). Аналогично, индекс заданного элемента можно найти с помощью itemNumber(). Текст каждого элемента можно получить с помощью функции itemText().

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

Элементы списка могут быть удалены по индексу с помощью функции removeItem(). remove() удаляет указанный элемент в списке.

Формат списка задаётся с помощью setFormat() и считывается с помощью format(). Формат описывает оформление самого списка, а не отдельных элементов.

См. также QTextBlock, QTextListFormat и QTextCursor.

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

void QTextList::add(const QTextBlock &block)

Добавляет указанный block в список.

См. также remove() и removeItem().

int QTextList::count() const

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

QTextListFormat QTextList::format() const

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

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

QTextBlock QTextList::item(int i) const

Возвращает i-й текстовый блок в списке.

См. также count() и itemText().

int QTextList::itemNumber(const QTextBlock &block) const

Возвращает индекс элемента списка, соответствующего заданному block. Возвращает -1, если блок не был найден в списке.

QString QTextList::itemText(const QTextBlock &block) const

Возвращает текст элемента списка, соответствующего заданному block.

void QTextList::remove(const QTextBlock &block)

Удаляет указанный block из списка.

См. также add() и removeItem().

void QTextList::removeItem(int i)

Удаляет элемент со значением индекса i из списка. Когда удаляется последний элемент списка, сам список автоматически удаляется QTextDocument, которому он принадлежит.

См. также add() и remove().

void QTextList::setFormat(const QTextListFormat &format)

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

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