En esta página

QTextList Class

La clase QTextList proporciona una lista decorada de elementos en un ` QTextDocument`. Más información...

Encabezado: #include <QTextList>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QTextBlockGroup

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

void add(const QTextBlock &block)
int count() const
QTextListFormat format() const
QTextBlock item(int i) const
int itemNumber(const QTextBlock &block) const
QString itemText(const QTextBlock &block) const
void remove(const QTextBlock &block)
void removeItem(int i)
void setFormat(const QTextListFormat &format)

Descripción detallada

Una lista contiene una secuencia de bloques de texto, cada uno de los cuales está marcado con una viñeta u otro símbolo. Se pueden utilizar varios niveles de listas, y la función de numeración automática permite crear listas ordenadas numéricamente y alfabéticamente.

Las listas se crean utilizando un cursor de texto para insertar una lista vacía en la posición actual o moviendo texto existente a una nueva lista. La función QTextCursor::insertList() inserta un bloque vacío en el documento en la posición del cursor y lo convierte en el primer elemento de una lista.

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

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

La función QTextCursor::createList() toma el contenido del bloque actual del cursor y lo convierte en el primer elemento de una nueva lista.

La lista actual del cursor se obtiene con QTextCursor::currentList().

El número de elementos de una lista se obtiene mediante la función « count()». Cada elemento puede obtenerse por su índice en la lista con la función « item()». Del mismo modo, el índice de un elemento determinado puede obtenerse con la función « itemNumber()». El texto de cada elemento puede obtenerse con la función « itemText()».

Ten en cuenta que los elementos de la lista pueden no ser elementos contiguos en el documento. Por ejemplo, los elementos de nivel superior de una lista de varios niveles estarán separados por los elementos de los niveles inferiores de la lista.

Los elementos de la lista se pueden eliminar por su índice mediante la función removeItem(). La función remove() elimina el elemento especificado de la lista.

El formato de la lista se establece con ` setFormat()` y se lee con ` format()`. El formato describe la presentación de la propia lista, y no la de los elementos individuales.

Véase también QTextBlock, QTextListFormat y QTextCursor.

Documentación de las funciones de miembro

void QTextList::add(const QTextBlock &block)

Incluye el elemento block en la lista.

Véase también remove() y removeItem().

int QTextList::count() const

Devuelve el número de elementos de la lista.

QTextListFormat QTextList::format() const

Devuelve el formato de la lista.

Véase también ` setFormat()`.

QTextBlock QTextList::item(int i) const

Devuelve el bloque de texto número i de la lista.

Véase también count() y itemText().

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

Devuelve el índice del elemento de la lista que corresponde al ` block` indicado. Devuelve -1 si el bloque no estaba presente en la lista.

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

Devuelve el texto del elemento de la lista que se corresponde con el ` block` indicado.

void QTextList::remove(const QTextBlock &block)

Elimina el elemento « block » indicado de la lista.

Véase también add() y removeItem().

void QTextList::removeItem(int i)

Elimina de la lista el elemento situado en la posición i. Cuando se elimina el último elemento de la lista, el QTextDocument al que pertenece la elimina automáticamente.

Véase también add() y remove().

void QTextList::setFormat(const QTextListFormat &format)

Establece el formato de la lista en « format ».

Véase también format().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.