QTextLength Class

Die Klasse QTextLength kapselt die verschiedenen Arten von Längen, die in einem QTextDocument verwendet werden. ...

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

Hinweis: Alle Funktionen in 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
QVariant operator QVariant() const
bool operator!=(const QTextLength &other) const
bool operator==(const QTextLength &other) const

Detaillierte 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 so verwendet wird, wie wir es erwarten. Wenn wir zum Beispiel eine Tabellenbreite angeben, kann der Wert eine feste Anzahl von Pixeln darstellen oder ein Prozentwert sein. Diese Informationen ändern sowohl die Bedeutung des Wertes als auch die Art und Weise, wie er verwendet wird.

Im Allgemeinen wird diese Klasse zur Angabe von Tabellenbreiten verwendet. Diese kann entweder als feste Anzahl von Pixeln, als Prozentsatz der Breite des enthaltenen Rahmens oder durch eine variable Breite angegeben werden, die es ermöglicht, genau den benötigten Platz einzunehmen.

Siehe auch QTextTable.

Dokumentation der Mitgliedstypen

enum QTextLength::Type

Diese Aufzählung beschreibt die verschiedenen Typen, die ein Längenobjekt haben kann.

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

Siehe auch type().

Dokumentation der Mitgliedsfunktionen

QTextLength::QTextLength()

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

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

Konstruiert ein neues Längenobjekt mit der angegebenen type und value.

qreal QTextLength::rawValue() const

Gibt den für den Typ der Länge spezifischen Beschränkungswert zurück. Wenn die Länge QTextLength::PercentageLength ist, dann ist der Rohwert in Prozent, im Bereich von 0 bis 100. Wenn die Länge QTextLength::FixedLength ist, 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, eingeschränkt durch den Typ des Längenobjekts und die angegebene maximumLength.

Siehe auch type().

QVariant 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 other Textlänge unterscheidet.

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

Gibt true zurück, wenn diese Textlänge mit der Textlänge von other identisch ist.

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