Auf dieser Seite

QTextLength Class

Die Klasse „QTextLength“ kapselt die verschiedenen Längentypen, die in einem „ QTextDocument “ verwendet werden. Mehr...

Header: #include <QTextLength>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Hinweis: Alle Funktionen dieser Klasse sind reentrant.

Öffentliche Typen

enum Type { VariableLength, FixedLength, PercentageLength }

Öffentliche Funktionen

QTextLength()
QTextLength(QTextLength::Type type, qreal value)
qreal rawValue() const
QTextLength::Type type() const
qreal value(qreal maximumLength) const
operator QVariant() const
bool operator!=(const QTextLength &other) const
bool operator==(const QTextLength &other) const

Ausführliche Beschreibung

Wenn wir einen Wert für die Länge eines Elements in einem Textdokument angeben, müssen wir oft weitere Informationen bereitstellen, damit die Länge wie erwartet verwendet wird. Wenn wir beispielsweise eine Tabellenbreite festlegen, kann der Wert eine feste Anzahl von Pixeln oder einen Prozentwert darstellen. Diese Angabe beeinflusst sowohl die Bedeutung des Werts als auch die Art und Weise, wie er verwendet wird.

Im Allgemeinen wird diese Klasse zur Festlegung von Tabellenbreiten verwendet. Diese können entweder als feste Anzahl von Pixeln, als Prozentsatz der Breite des umgebenden Rahmens oder als variable Breite angegeben werden, die es der Tabelle ermöglicht, genau den Platz einzunehmen, den sie benötigt.

Siehe auch „ QTextTable “.

Dokumentation zu den Mitgliedstypen

enum QTextLength::Type

Diese Enumeration beschreibt die verschiedenen Typen, die ein Längenobjekt annehmen kann.

KonstanteWertBeschreibung
QTextLength::VariableLength0Die Breite des Objekts ist variabel
QTextLength::FixedLength1Die Breite des Objekts ist fest
QTextLength::PercentageLength2Die Breite des Objekts wird in Prozent der maximalen Breite angegeben

Siehe auch ` type()`.

Dokumentation der Member-Funktionen

QTextLength::QTextLength()

Erstellt ein neues Längenobjekt, das eine variable Größe darstellt.

[explicit] QTextLength::QTextLength(QTextLength::Type type, qreal value)

Erstellt ein neues Längenobjekt aus den angegebenen Werten „ type “ und „ value “.

qreal QTextLength::rawValue() const

Gibt den für den Typ der Länge spezifischen Begrenzungswert zurück. Wenn es sich bei der Länge um „ QTextLength::PercentageLength “ handelt, liegt der Rohwert im Bereich von 0 bis 100 Prozent. Wenn es sich bei der Länge um „ QTextLength::FixedLength “ handelt, wird dieser feste Wert zurückgegeben. Bei variablen Längen wird Null zurückgegeben.

QTextLength::Type QTextLength::type() const

Gibt den Typ dieses Längenobjekts zurück.

Siehe auch „ QTextLength::Type “.

qreal QTextLength::value(qreal maximumLength) const

Gibt die effektive Länge zurück, die durch den Typ des Längenobjekts und den angegebenen Wert „ maximumLength “ begrenzt ist.

Siehe auch ` type()` .

QTextLength::operator QVariant() const

Gibt die Textlänge als QVariant

bool QTextLength::operator!=(const QTextLength &other) const

Gibt „ true “ zurück, wenn sich diese Textlänge von der Textlänge von „ other “ unterscheidet.

bool QTextLength::operator==(const QTextLength &other) const

Gibt „ true “ zurück, wenn diese Textlänge mit der Textlänge von „ other “ übereinstimmt.

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