QTextList Class

Description détaillée

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

Les listes sont créées à l'aide d'un curseur de texte permettant d'insérer une liste vide à la position courante ou de déplacer du texte existant vers 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() récupère le contenu du bloc actuel du curseur et le transforme en premier élément d’une nouvelle liste.

La liste actuelle du curseur est récupérée à l'aide de ` QTextCursor::currentList()`.

Le nombre d’éléments d’une liste est fourni par la fonction ` count()`. Chaque élément peut être récupéré à partir de son index dans la liste à l’aide de la fonction ` item()`. De même, l’index d’un élément donné peut être obtenu à l’aide de la fonction ` itemNumber()`. Le texte de chaque élément peut être récupéré à l’aide de la fonction ` itemText()`.

Notez que les éléments de la liste ne sont pas nécessairement contigus dans le document. Par exemple, les éléments de niveau supérieur 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 leur index à l’aide de la fonction removeItem(). La fonction remove() supprime l’élément spécifié de la liste.

Le format de la liste est défini à l’aide de la fonction ` setFormat()` et lu à l’aide de la fonction ` format()`. Le format décrit la mise en forme de la liste elle-même, et non celle des éléments individuels.