QTextLength Class

The QTextLength class encapsulates the different types of length used in a QTextDocument. More...

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

List of all members, including inherited members
QTextLength is part of Rich Text Processing APIs.

Note: All functions in this class are reentrant.

Public Types

enum	Type { VariableLength, FixedLength, PercentageLength }

Public Functions

	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

Detailed Description

When we specify a value for the length of an element in a text document, we often need to provide some other information so that the length is used in the way we expect. For example, when we specify a table width, the value can represent a fixed number of pixels, or it can be a percentage value. This information changes both the meaning of the value and the way it is used.

Generally, this class is used to specify table widths. These can be specified either as a fixed amount of pixels, as a percentage of the containing frame's width, or by a variable width that allows it to take up just the space it requires.

See also QTextTable.

Member Type Documentation

enum QTextLength::Type

This enum describes the different types a length object can have.

Constant	Value	Description
`QTextLength::VariableLength`	`0`	The width of the object is variable
`QTextLength::FixedLength`	`1`	The width of the object is fixed
`QTextLength::PercentageLength`	`2`	The width of the object is in percentage of the maximum width

See also type().

Member Function Documentation

QTextLength::QTextLength()

Constructs a new length object which represents a variable size.

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

Constructs a new length object of the given type and value.

qreal QTextLength::rawValue() const

Returns the constraint value that is specific for the type of the length. If the length is QTextLength::PercentageLength then the raw value is in percent, in the range of 0 to 100. If the length is QTextLength::FixedLength then that fixed amount is returned. For variable lengths, zero is returned.

QTextLength::Type QTextLength::type() const

Returns the type of this length object.

See also QTextLength::Type.

qreal QTextLength::value(qreal maximumLength) const

Returns the effective length, constrained by the type of the length object and the specified maximumLength.

See also type().

QVariant QTextLength::operator QVariant() const

Returns the text length as a QVariant

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

Returns true if this text length is different from the other text length.

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

Returns true if this text length is the same as the other text length.

Contents