QTextList Class

Detaillierte Beschreibung

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

Listen werden erstellt, indem ein Textcursor verwendet wird, um eine leere Liste an der aktuellen Position einzufügen, oder indem vorhandener Text in eine neue Liste verschoben wird. Die Funktion QTextCursor::insertList() fügt einen leeren Block an der Cursorposition in das Dokument ein und macht ihn zum ersten Eintrag in 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 des Cursors und macht ihn zum ersten Element einer neuen Liste.

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

Die Anzahl der Elemente in einer Liste wird mit count() angegeben. Jedes Element kann über seinen Index in der Liste mit der Funktion item() ermittelt werden. In ähnlicher Weise kann der Index eines bestimmten Eintrags mit itemNumber() ermittelt werden. Der Text eines jeden Eintrags kann mit der Funktion itemText() ermittelt werden.

Beachten Sie, dass die Elemente in der Liste nicht unbedingt benachbarte Elemente des Dokuments sein müssen. Zum Beispiel werden die Elemente der obersten Ebene in einer mehrstufigen Liste durch die Elemente der unteren Ebenen der Liste getrennt.

Listenelemente können nach Index mit der Funktion removeItem() gelöscht werden. remove() löscht das angegebene Element in der Liste.

Das Format der Liste wird mit setFormat() gesetzt und mit format() gelesen. Das Format beschreibt die Gestaltung der Liste selbst und nicht die einzelnen Elemente.