class QTextLength#

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

Inheritance diagram of PySide6.QtGui.QTextLength

Synopsis#

Methods#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

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

class Type#

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

Constant

Description

QTextLength.VariableLength

The width of the object is variable

QTextLength.FixedLength

The width of the object is fixed

QTextLength.PercentageLength

The width of the object is in percentage of the maximum width

See also

type()

__init__()#

Constructs a new length object which represents a variable size.

__init__(type, value)
Parameters:
  • typeType

  • value – float

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

__ne__(other)#
Parameters:

otherQTextLength

Return type:

bool

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

__eq__(other)#
Parameters:

otherQTextLength

Return type:

bool

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

rawValue()#
Return type:

float

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

type()#
Return type:

Type

Returns the type of this length object.

See also

Type

value(maximumLength)#
Parameters:

maximumLength – float

Return type:

float

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

See also

type()