QTextOption Class
Die Klasse „QTextOption“ enthält eine Beschreibung allgemeiner Rich-Text-Eigenschaften. Mehr...
| Header: | #include <QTextOption> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextOption ist Teil der Rich-Text-Verarbeitungs-APIs.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Typen
| struct | Tab |
| enum | Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, ShowDefaultIgnorables, …, DisableEmojiParsing } |
| flags | Flags |
| enum | TabType { LeftTab, RightTab, CenterTab, DelimiterTab } |
| enum | WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere } |
Öffentliche Funktionen
| QTextOption() | |
| QTextOption(Qt::Alignment alignment) | |
| QTextOption(const QTextOption &other) | |
| ~QTextOption() | |
| Qt::Alignment | alignment() const |
| QTextOption::Flags | flags() const |
| void | setAlignment(Qt::Alignment alignment) |
| void | setFlags(QTextOption::Flags flags) |
| void | setTabArray(const QList<qreal> &tabStops) |
| void | setTabStopDistance(qreal tabStopDistance) |
| void | setTabs(const QList<QTextOption::Tab> &tabStops) |
| void | setTextDirection(Qt::LayoutDirection direction) |
| void | setUseDesignMetrics(bool enable) |
| void | setWrapMode(QTextOption::WrapMode mode) |
| QList<qreal> | tabArray() const |
| qreal | tabStopDistance() const |
| QList<QTextOption::Tab> | tabs() const |
| Qt::LayoutDirection | textDirection() const |
| bool | useDesignMetrics() const |
| QTextOption::WrapMode | wrapMode() const |
| QTextOption & | operator=(const QTextOption &other) |
Ausführliche Beschreibung
QTextOption dient dazu, gängige Rich-Text-Eigenschaften in einem einzigen Objekt zu kapseln. Es enthält Informationen zur Textausrichtung, zur Schreibrichtung, zum Zeilenumbruch und zu anderen Standardeigenschaften im Zusammenhang mit der Textdarstellung und dem Layout.
Siehe auch „ QTextEdit “, „ QTextDocument “ und „ QTextCursor “.
Dokumentation zu den Mitgliedstypen
enum QTextOption::Flag
flags QTextOption::Flags
| Konstante | Wert | Beschreibung |
|---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | Wenn diese Option aktiviert ist, geben die Funktionen „ QTextLine::naturalTextWidth()“ und „naturalTextRect()“ einen Wert zurück, der die Breite der nachgestellten Leerzeichen im Text einschließt; andernfalls wird diese Breite nicht berücksichtigt. |
QTextOption::ShowTabsAndSpaces | 0x1 | Leerzeichen werden als kleine Punkte und Tabulatoren als kleine Pfeile dargestellt. Geschützte Leerzeichen werden anders dargestellt als trennbare Leerzeichen. |
QTextOption::ShowLineAndParagraphSeparators | 0x2 | Zeilen- und Absatztrennzeichen werden mit entsprechenden Symbolzeichen dargestellt. |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | Das Ende des Dokuments wird mit einem Abschnittszeichen dargestellt. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9) | 0x20 | Rendern Sie normalerweise nicht sichtbare Zeichen, sofern dies von der Schriftart unterstützt wird. |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | Berücksichtigen Sie bei der Bestimmung der Zeilenumbruchpositionen den zusätzlichen Abstand, der für die Darstellung eines Trennzeichens benötigt wird. |
QTextOption::SuppressColors | 0x8 | Unterdrücken Sie alle Farbänderungen in den Zeichenformaten (mit Ausnahme der Hauptauswahl). |
QTextOption::DisableEmojiParsing (since Qt 6.9) | 0x40 | Standardmäßig erkennt Qt Emoji-Sequenzen in Eingabezeichenfolgen und priorisiert die Verwendung von Farbschriften für deren Darstellung. Dieser zusätzliche Schritt kann durch Setzen des Flags „DisableEmojiParsing“ deaktiviert werden, wenn im Voraus bekannt ist, dass er nicht benötigt wird. |
Der Typ „Flags“ ist ein typedef für QFlags<Flag>. Er speichert eine ODER-Kombination von Flag-Werten.
enum QTextOption::TabType
Diese Enumeration enthält die verschiedenen Tabulatorarten
| Konstante | Wert | Beschreibung |
|---|---|---|
QTextOption::LeftTab | 0 | Ein linker Tabulator |
QTextOption::RightTab | 1 | Ein rechter Tabulator |
QTextOption::CenterTab | 2 | Ein zentrierter Tabulator |
QTextOption::DelimiterTab | 3 | Ein Tabulator, der an einem bestimmten Trennzeichen stoppt |
enum QTextOption::WrapMode
Diese Enumeration beschreibt, wie Text in einem Dokument umgebrochen wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QTextOption::NoWrap | 0 | Der Text wird überhaupt nicht umgebrochen. |
QTextOption::WordWrap | 1 | Der Text wird an Wortgrenzen umgebrochen. |
QTextOption::ManualWrap | 2 | Entspricht QTextOption::NoWrap |
QTextOption::WrapAnywhere | 3 | Der Text kann an jeder beliebigen Stelle einer Zeile umgebrochen werden, auch wenn dies mitten in einem Wort geschieht. |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | Wenn möglich, erfolgt der Zeilenumbruch an einer Wortgrenze; andernfalls erfolgt er an einer geeigneten Stelle in der Zeile, auch mitten in einem Wort. |
Dokumentation der Mitgliedsfunktionen
QTextOption::QTextOption()
Erstellt eine Textoption mit Standardeigenschaften für Text. Die Eigenschaft für die Textausrichtung wird auf „ Qt::AlignLeft “ gesetzt. Die Eigenschaft für den Zeilenumbruch wird auf „ QTextOption::WordWrap “ gesetzt. Das Flag für die Verwendung von Designmetriken wird auf „false“ gesetzt.
Hinweis: Durch den Aufruf dieses Konstruktors wird die Standard-Textrichtung auf „ Qt::LayoutDirectionAuto “ gesetzt.
QTextOption::QTextOption(Qt::Alignment alignment)
Erstellt eine Textoption mit der angegebenen Textausrichtung („ alignment “). Die Eigenschaft „word wrap“ wird auf „ QTextOption::WordWrap “ gesetzt. Das Flag „using of design metrics“ wird auf „false“ gesetzt.
Hinweis: Durch den Aufruf dieses Konstruktors wird die Standard-Textrichtung auf den aktuellen Wert von ` QGuiApplication::layoutDirection()` gesetzt, der von der Systemlokalisierung abhängt. Aus Gründen der Abwärtskompatibilität stimmt dies nicht mit der vom Standardkonstruktor festgelegten Standard-Textrichtung überein.
QTextOption::QTextOption(const QTextOption &other)
Erstellen Sie eine Kopie der Textoption „ other “.
[noexcept] QTextOption::~QTextOption()
Löscht die Textoption.
Qt::Alignment QTextOption::alignment() const
Gibt die durch die Option definierte Textausrichtung zurück.
Siehe auch „ setAlignment()“.
QTextOption::Flags QTextOption::flags() const
Gibt die mit der Option verbundenen Flags zurück.
Siehe auch „ setFlags()“.
void QTextOption::setAlignment(Qt::Alignment alignment)
Legt die Textausrichtung der Option auf die angegebene „ alignment “ fest.
Siehe auch ` alignment()`.
void QTextOption::setFlags(QTextOption::Flags flags)
Setzt die mit der Option verbundenen Flags auf den angegebenen Wert flags.
Siehe auch flags().
void QTextOption::setTabArray(const QList<qreal> &tabStops)
Legt die Tabulatorpositionen für das Textlayout so fest, wie sie unter tabStops angegeben sind.
Siehe auch tabArray(), setTabStopDistance() und setTabs().
void QTextOption::setTabStopDistance(qreal tabStopDistance)
Legt den Standardabstand zwischen Tabulatoren in Geräteeinheiten auf den unter tabStopDistance angegebenen Wert fest.
Siehe auch tabStopDistance(), setTabArray(), setTabs() und tabs().
void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)
Legt die Tabulatorpositionen für das Textlayout auf die unter tabStops angegebenen Werte fest.
Siehe auch tabs() und tabStopDistance().
void QTextOption::setTextDirection(Qt::LayoutDirection direction)
Legt die Richtung des durch die Option definierten Textlayouts auf den angegebenen Wert „ direction “ fest.
Siehe auch ` textDirection()` .
void QTextOption::setUseDesignMetrics(bool enable)
Wenn „ enable “ auf „true“ gesetzt ist, verwendet das Layout Design-Metriken; andernfalls werden die Metriken des Paint-Geräts verwendet (was dem Standardverhalten entspricht).
Siehe auch useDesignMetrics().
void QTextOption::setWrapMode(QTextOption::WrapMode mode)
Stellt den Zeilenumbruchmodus der Option auf den angegebenen Wert „ mode “ ein.
Siehe auch wrapMode().
QList<qreal> QTextOption::tabArray() const
Gibt eine Liste der für das Textlayout definierten Tabulatorpositionen zurück.
Siehe auch setTabArray() und tabStopDistance().
qreal QTextOption::tabStopDistance() const
Gibt den Abstand zwischen Tabulatoren in Geräteeinheiten zurück.
Siehe auch setTabStopDistance(), tabArray(), setTabs() und tabs().
QList<QTextOption::Tab> QTextOption::tabs() const
Gibt eine Liste der für das Textlayout definierten Tabulatorpositionen zurück.
Siehe auch tabStopDistance(), setTabs() und setTabStopDistance().
Qt::LayoutDirection QTextOption::textDirection() const
Gibt die durch die Option definierte Richtung des Textlayouts zurück.
Hinweis: Aus Gründen der Abwärtskompatibilität unterscheidet sich der Standardwert für die Textrichtung je nachdem, welcher Konstruktor verwendet wird. Einzelheiten finden Sie in der Dokumentation zu den jeweiligen Konstruktoren.
Siehe auch ` setTextDirection()`.
bool QTextOption::useDesignMetrics() const
Gibt „ true “ zurück, wenn das Layout Design- statt Geräte-Metriken verwendet; andernfalls wird „ false “ zurückgegeben.
Siehe auch setUseDesignMetrics().
QTextOption::WrapMode QTextOption::wrapMode() const
Gibt den durch die Option definierten Textumbruchmodus zurück.
Siehe auch „ setWrapMode()“.
QTextOption &QTextOption::operator=(const QTextOption &other)
Gibt „ true “ zurück, wenn die Textoption mit der Textoption „ other “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
© 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.
