QTextListFormat Class
Die Klasse „QTextListFormat“ stellt Formatierungsinformationen für Listen in einem „ QTextDocument “ bereit. Mehr...
| Header: | #include <QTextListFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QTextFormat |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextListFormat ist Teil der Rich-Text-Verarbeitungs-APIs und der implizit gemeinsam genutzten Klassen.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Typen
| enum | Style { ListDisc, ListCircle, ListSquare, ListDecimal, ListLowerAlpha, …, ListUpperRoman } |
Öffentliche Funktionen
| QTextListFormat() | |
| int | indent() const |
| bool | isValid() const |
| QString | numberPrefix() const |
| QString | numberSuffix() const |
| void | setIndent(int indentation) |
| void | setNumberPrefix(const QString &numberPrefix) |
| void | setNumberSuffix(const QString &numberSuffix) |
(since 6.6) void | setStart(int start) |
| void | setStyle(QTextListFormat::Style style) |
(since 6.6) int | start() const |
| QTextListFormat::Style | style() const |
Ausführliche Beschreibung
Eine Liste besteht aus einem oder mehreren Elementen, die als Textblöcke dargestellt werden. Das Format der Liste legt das Erscheinungsbild der Elemente in der Liste fest. Insbesondere bestimmt es die Einrückung und den Stil jedes Elements.
Die Einrückung der Elemente ist ein ganzzahliger Wert, der bewirkt, dass jedes Element um einen bestimmten Betrag vom linken Rand versetzt wird. Dieser Wert wird mit ` indent()` ausgelesen und mit ` setIndent()` gesetzt.
Der Stil, mit dem die einzelnen Elemente gestaltet werden, wird mit ` setStyle()` festgelegt und kann mit der Funktion ` style()` ausgelesen werden. Der Stil steuert die Art der Aufzählungszeichen und das Nummerierungsschema, das für die Elemente in der Liste verwendet wird. Beachten Sie, dass Listen, die das dezimale Nummerierungsschema verwenden, bei 1 statt bei 0 beginnen, sofern dies nicht über ` setStart()` überschrieben wurde.
Es können Stileigenschaften festgelegt werden, um das Erscheinungsbild der Listenelemente weiter anzupassen; beispielsweise können die Eigenschaften `ListNumberPrefix` und `ListNumberSuffix` verwendet werden, um die in einer nummerierten Liste verwendeten Zahlen so anzupassen, dass sie als (1), (2), (3) usw. erscheinen:
QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
listFormat.setNumberPrefix("(");
listFormat.setNumberSuffix(")");
cursor.insertList(listFormat);Siehe auch „ QTextList “.
Dokumentation zu Mitgliedstypen
enum QTextListFormat::Style
Diese Enumeration beschreibt die Symbole, die zur Gestaltung von Listenelementen verwendet werden:
| Konstante | Wert | Beschreibung |
|---|---|---|
QTextListFormat::ListDisc | -1 | ein ausgefüllter Kreis |
QTextListFormat::ListCircle | -2 | ein leerer Kreis |
QTextListFormat::ListSquare | -3 | ein ausgefülltes Quadrat |
QTextListFormat::ListDecimal | -4 | Dezimalwerte in aufsteigender Reihenfolge |
QTextListFormat::ListLowerAlpha | -5 | lateinische Kleinbuchstaben in alphabetischer Reihenfolge |
QTextListFormat::ListUpperAlpha | -6 | lateinische Großbuchstaben in alphabetischer Reihenfolge |
QTextListFormat::ListLowerRoman | -7 | kleine römische Ziffern (unterstützt nur bis zu 4999 Einträge) |
QTextListFormat::ListUpperRoman | -8 | römische Ziffern in Großbuchstaben (unterstützt nur bis zu 4999 Einträge) |
Dokumentation der Mitgliedsfunktionen
QTextListFormat::QTextListFormat()
Erstellt ein neues Objekt im Listenformat.
int QTextListFormat::indent() const
Gibt die Einrückung des Listenformats zurück. Die Einrückung wird mit der Eigenschaft „ QTextDocument::indentWidth “ multipliziert, um die effektive Einrückung in Pixeln zu erhalten.
Siehe auch „ setIndent()“.
bool QTextListFormat::isValid() const
Gibt „ true “ zurück, wenn dieses Listenformat gültig ist; andernfalls wird „ false “ zurückgegeben.
QString QTextListFormat::numberPrefix() const
Gibt das Zahlenpräfix des Listenformats zurück.
Siehe auch „ setNumberPrefix()“.
QString QTextListFormat::numberSuffix() const
Gibt das Zahlensuffix des Listenformats zurück.
Siehe auch „ setNumberSuffix()“.
void QTextListFormat::setIndent(int indentation)
Legt die „ indentation “ des Listenformats fest. Die Einrückung wird mit der Eigenschaft „ QTextDocument::indentWidth “ multipliziert, um die tatsächliche Einrückung in Pixeln zu erhalten.
Siehe auch ` indent()`.
void QTextListFormat::setNumberPrefix(const QString &numberPrefix)
Legt das Zahlenpräfix des Listenformats auf die durch „ numberPrefix “ angegebene Zeichenkette fest. Dies kann bei allen sortierten Listentypen verwendet werden. Bei unsortierten Listentypen hat dies keine Auswirkung.
Das Standardpräfix ist eine leere Zeichenkette.
Siehe auch ` numberPrefix()`.
void QTextListFormat::setNumberSuffix(const QString &numberSuffix)
Legt das Zahlensuffix des Listenformats auf die durch „ numberSuffix “ angegebene Zeichenfolge fest. Dies kann bei allen sortierten Listentypen verwendet werden. Bei unsortierten Listentypen hat dies keine Auswirkung.
Das Standard-Suffix ist „.“.
Siehe auch ` numberSuffix()`.
[since 6.6] void QTextListFormat::setStart(int start)
Legt den Index „ start “ des Listenformats fest.
Dadurch können Sie eine Liste mit einem anderen Index als 1 beginnen. Dies kann bei allen sortierten Listentypen verwendet werden: Wenn beispielsweise ` style()` den Wert ` QTextListFormat::ListLowerAlpha ` und ` start()` den Wert ` 4` hat, beginnt das erste Listenelement mit „d“. Bei unsortierten Listentypen hat dies keine Auswirkung.
Der Standardstartwert ist 1.
Diese Funktion wurde in Qt 6.6 eingeführt.
Siehe auch start().
void QTextListFormat::setStyle(QTextListFormat::Style style)
Legt die „ style “ des Listenformats fest.
Siehe auch „ style()“ und „ Style “.
[since 6.6] int QTextListFormat::start() const
Gibt die Nummer zurück, die beim ersten Listenelement angezeigt werden soll, wenn die Funktion „ style()“ den Wert „ QTextListFormat::ListDecimal “ zurückgibt, oder dient zum Versetzen anderer sortierter Listentypen.
Diese Funktion wurde in Qt 6.6 eingeführt.
Siehe auch ` setStart()`.
QTextListFormat::Style QTextListFormat::style() const
Gibt den Stil des Listenformats zurück.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
