QTextList Class

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. Pueden utilizarse varios niveles de listas, y la función de numeración automática permite ordenar listas numéricas y alfabéticas.

Las listas se crean utilizando un cursor de texto para insertar una lista vacía en la posición actual o moviendo el 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 encuentra con QTextCursor::currentList().

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

Tenga en cuenta que los elementos de la lista pueden no ser elementos adyacentes en el documento. Por ejemplo, los elementos del 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 pueden eliminarse por índice con la función removeItem(). remove() borra el elemento especificado de la lista.

El formato de la lista se establece con setFormat() y se lee con format(). El formato describe la decoración de la lista en sí, y no los elementos individuales.