QTextOption Class

Die Klasse QTextOption bietet eine Beschreibung allgemeiner Rich-Text-Eigenschaften. Mehr...

Kopfzeile:	`#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 Processing APIs.

Hinweis: Alle Funktionen in dieser Klasse sind reentrant.

Öffentliche Typen

struct	Tab
enum	Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, AddSpaceForLineAndParagraphSeparators, SuppressColors }
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)

Detaillierte Beschreibung

QTextOption wird verwendet, um allgemeine Rich-Text-Eigenschaften in einem einzigen Objekt zu kapseln. Sie enthält Informationen über die Textausrichtung, die Layoutrichtung, den Wortumbruch und andere Standardeigenschaften im Zusammenhang mit der Textdarstellung und dem Layout.

Siehe auch QTextEdit, QTextDocument, und QTextCursor.

Dokumentation der Mitgliedstypen

enum QTextOption::Flag
flags QTextOption::Flags

Konstante	Wert	Beschreibung
`QTextOption::IncludeTrailingSpaces`	`0x80000000`	Wenn diese Option gesetzt ist, geben 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 mit kleinen Punkten und Tabulatoren mit kleinen Pfeilen dargestellt. Nicht umbrechende Leerzeichen werden anders dargestellt als umbrechende Leerzeichen.
`QTextOption::ShowLineAndParagraphSeparators`	`0x2`	Visualisieren Sie Zeilen- und Absatztrenner mit entsprechenden Symbolzeichen.
`QTextOption::ShowDocumentTerminator (since Qt 5.7)`	`0x10`	Visualisieren Sie das Ende des Dokuments mit einem Abschnittszeichen.
`QTextOption::AddSpaceForLineAndParagraphSeparators`	`0x4`	Berücksichtigen Sie bei der Festlegung der Zeilenumbruchpositionen den Platz, der für das Zeichnen eines Trennzeichens hinzugefügt wird.
`QTextOption::SuppressColors`	`0x8`	Unterdrücken Sie alle Farbwechsel in den Zeichenformaten (außer der Hauptauswahl).

Der Typ Flags ist ein Typedef für QFlags<Flag>. Er speichert eine ODER-Kombination von Flag-Werten.

enum QTextOption::TabType

Diese Aufzählung enthält die verschiedenen Arten von Tabulatoren

Konstante	Wert	Beschreibung
`QTextOption::LeftTab`	`0`	Ein Links-Tabulator
`QTextOption::RightTab`	`1`	Ein Rechts-Tabulator
`QTextOption::CenterTab`	`2`	Ein zentrierter Tabulator
`QTextOption::DelimiterTab`	`3`	Ein Tabulator, der bei einem bestimmten Begrenzungszeichen aufhört

enum QTextOption::WrapMode

Diese Aufzählung beschreibt, wie der Text in einem Dokument umbrochen wird.

Konstante	Wert	Beschreibung
`QTextOption::NoWrap`	`0`	Text wird überhaupt nicht umgebrochen.
`QTextOption::WordWrap`	`1`	Der Text wird an den Wortgrenzen umgebrochen.
`QTextOption::ManualWrap`	`2`	Dasselbe wie QTextOption::NoWrap
`QTextOption::WrapAnywhere`	`3`	Text kann an jeder beliebigen Stelle einer Zeile umbrochen werden, auch wenn er in der Mitte eines Wortes steht.
`QTextOption::WrapAtWordBoundaryOrAnywhere`	`4`	Wenn möglich, erfolgt der Umbruch an einer Wortgrenze; andernfalls erfolgt er an der entsprechenden Stelle der Zeile, auch mitten im Wort.

Dokumentation der Mitgliedsfunktionen

QTextOption::QTextOption()

Konstruiert eine Textoption mit Standardeigenschaften für Text. Die Eigenschaft für die Textausrichtung wird auf Qt::AlignLeft gesetzt. Die Eigenschaft für den Wortumbruch wird auf QTextOption::WordWrap gesetzt. Das Kennzeichen für die Verwendung von Entwurfsmetriken wird auf false gesetzt.

QTextOption::QTextOption(Qt::Alignment alignment)

Konstruiert eine Textoption mit dem angegebenen alignment für Text. Die Eigenschaft "Wortumbruch" wird auf QTextOption::WordWrap gesetzt. Das Flag "Verwendung von Entwurfsmetriken" wird auf false gesetzt.

QTextOption::QTextOption(const QTextOption &other)

Konstruieren Sie eine Kopie der Option other text.

`[noexcept]` QTextOption::~QTextOption()

Zerstört 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)

Setzt die Textausrichtung der Option auf die angegebene alignment.

Siehe auch alignment().

void QTextOption::setFlags(QTextOption::Flags flags)

Setzt die mit der Option verbundenen Flaggen auf die angegebene flags.

Siehe auch flags().

void QTextOption::setTabArray(const QList<qreal> &tabStops)

Setzt die Tabulatorpositionen für das Textlayout auf die von tabStops angegebenen.

Siehe auch tabArray(), setTabStopDistance(), und setTabs().

void QTextOption::setTabStopDistance(qreal tabStopDistance)

Setzt den Standardabstand in Geräteeinheiten zwischen Tabulatorstopps auf den durch tabStopDistance angegebenen Wert.

Siehe auch tabStopDistance(), setTabArray(), setTabs(), und tabs().

void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)

Setzt die Tabulatorpositionen für das Textlayout auf die von tabStops angegebenen.

Siehe auch tabs() und tabStopDistance().

void QTextOption::setTextDirection(Qt::LayoutDirection direction)

Setzt die Richtung des durch die Option definierten Textlayouts auf die angegebene direction.

Siehe auch textDirection().

void QTextOption::setUseDesignMetrics(bool enable)

Wenn enable wahr ist, verwendet das Layout Design-Metriken; andernfalls werden die Metriken des Malgeräts verwendet (dies ist das Standardverhalten).

Siehe auch useDesignMetrics().

void QTextOption::setWrapMode(QTextOption::WrapMode mode)

Setzt den Textumbruchmodus der Option auf den angegebenen mode.

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 den Tabulatorstopps 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 Richtung des durch die Option definierten Textlayouts zurück.

Siehe auch setTextDirection().

bool QTextOption::useDesignMetrics() const

Gibt true zurück, wenn das Layout Design- und nicht Gerätemetriken verwendet; andernfalls false.

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.

© 2025 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.