QTextList Class

Ausführliche Beschreibung

Eine Liste enthält eine Abfolge von Textblöcken, von denen jeder mit einem Aufzählungszeichen oder einem anderen Symbol gekennzeichnet ist. Es können Listen mit mehreren Ebenen verwendet werden, und die automatische Nummerierungsfunktion bietet Unterstützung für geordnete numerische und alphabetische Listen.

Listen werden erstellt, indem mit einem Textcursor an der aktuellen Position eine leere Liste eingefügt wird oder indem vorhandener Text in eine neue Liste verschoben wird. Die Funktion ` QTextCursor::insertList()` fügt an der Cursorposition einen leeren Block in das Dokument ein und macht ihn zum ersten Element einer Liste.

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

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

Die Funktion ` QTextCursor::createList()` übernimmt den Inhalt des aktuellen Blocks am Cursor und wandelt ihn in den ersten Eintrag einer neuen Liste um.

Die aktuelle Liste des Cursors wird mit ` QTextCursor::currentList()` ermittelt.

Die Anzahl der Elemente in einer Liste wird von ` count()` zurückgegeben. Jedes Element kann anhand seines Index in der Liste mit der Funktion ` item()` abgerufen werden. Ebenso lässt sich der Index eines bestimmten Elements mit ` itemNumber()` ermitteln. Der Text jedes Elements kann mit der Funktion ` itemText()` abgerufen werden.

Beachten Sie, dass die Elemente in der Liste möglicherweise keine benachbarten Elemente im Dokument sind. Beispielsweise werden die Elemente der obersten Ebene in einer mehrstufigen Liste durch die Elemente der unteren Ebenen der Liste getrennt.

Listenelemente können anhand ihres Index mit der Funktion ` removeItem()` gelöscht werden. ` remove()` löscht das angegebene Element aus der Liste.

Das Format der Liste wird mit ` setFormat()` festgelegt und mit ` format()` ausgelesen. Das Format beschreibt die Gestaltung der Liste selbst und nicht die einzelnen Elemente.