QTextList Class

Description détaillée

Une liste contient une séquence de blocs de texte, chacun étant marqué par une puce ou un autre symbole. Il est possible d'utiliser plusieurs niveaux de listes et la fonction de numérotation automatique prend en charge les listes numériques et alphabétiques ordonnées.

Les listes sont créées en utilisant un curseur de texte pour insérer une liste vide à la position actuelle ou en déplaçant du texte existant dans une nouvelle liste. La fonction QTextCursor::insertList() insère un bloc vide dans le document à la position du curseur et en fait le premier élément d'une liste.

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

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

La fonction QTextCursor::createList() prend le contenu du bloc actuel du curseur et le transforme en premier élément d'une nouvelle liste.

La liste actuelle du curseur est trouvée avec QTextCursor::currentList().

Le nombre d'éléments d'une liste est donné par count(). Chaque élément peut être obtenu par son index dans la liste avec la fonction item(). De même, l'index d'un élément donné peut être trouvé avec itemNumber(). Le texte de chaque élément peut être trouvé avec la fonction itemText().

Notez que les éléments de la liste peuvent ne pas être des éléments adjacents dans le document. Par exemple, les éléments de premier niveau d'une liste à plusieurs niveaux seront séparés par les éléments des niveaux inférieurs de la liste.

Les éléments de la liste peuvent être supprimés par index à l'aide de la fonction removeItem(). remove() supprime l'élément spécifié dans la liste.

Le format de la liste est défini avec setFormat() et lu avec format(). Le format décrit la décoration de la liste elle-même, et non les éléments individuels.