QTextLine

The QTextLine class represents a line of text inside a QTextLayout . More…

Synopsis

Functions

• def ascent ()

• def cursorToX (cursorPos[, edge=QTextLine.Edge.Leading])

• def descent ()

• def draw (painter, position)

• def glyphRuns ([from=-1[, length=-1]])

• def height ()

• def horizontalAdvance ()

• def isValid ()

• def leading ()

• def leadingIncluded ()

• def lineNumber ()

• def naturalTextRect ()

• def naturalTextWidth ()

• def position ()

• def rect ()

• def setLeadingIncluded (included)

• def setLineWidth (width)

• def setNumColumns (columns)

• def setNumColumns (columns, alignmentWidth)

• def setPosition (pos)

• def textLength ()

• def textStart ()

• def width ()

• def x ()

• def xToCursor (x[, edge=QTextLine.CursorPosition.CursorBetweenCharacters])

• def y ()

Detailed Description

A text line is usually created by createLine() .

After being created, the line can be filled using the setLineWidth() or setNumColumns() functions. A line has a number of attributes including the rectangle it occupies, rect() , its coordinates, x() and y() , its textLength() , width() and naturalTextWidth() , and its ascent() and descent() relative to the text. The position of the cursor in terms of the line is available from cursorToX() and its inverse from xToCursor() . A line can be moved with setPosition() .

class PySide6.QtGui.QTextLine

Creates an invalid line.

PySide6.QtGui.QTextLine.Edge

Constant	Description
QTextLine.Leading
QTextLine.Trailing

PySide6.QtGui.QTextLine.CursorPosition

Constant	Description
QTextLine.CursorBetweenCharacters
QTextLine.CursorOnCharacter

PySide6.QtGui.QTextLine.ascent()

Return type

float

Returns the line’s ascent.

See also

descent() height()

PySide6.QtGui.QTextLine.cursorToX(cursorPos[, edge=QTextLine.Edge.Leading])

Parameters

• cursorPos – int

• edge – Edge

Return type

PyObject

This is an overloaded function.

PySide6.QtGui.QTextLine.descent()

Return type

float

Returns the line’s descent.

See also

ascent() height()

PySide6.QtGui.QTextLine.draw(painter, position)

Parameters

• painter – PySide6.QtGui.QPainter

• position – PySide6.QtCore.QPointF

Draws a line on the given painter at the specified position.

PySide6.QtGui.QTextLine.glyphRuns([from=-1[, length=-1]])

Parameters

• from – int

• length – int

Return type

Returns the glyph indexes and positions for all glyphs in this QTextLine for characters in the range defined by from and length. The from index is relative to the beginning of the text in the containing QTextLayout , and the range must be within the range of QTextLine as given by functions textStart() and textLength() .

If from is negative, it will default to textStart() , and if length is negative it will default to the return value of textLength() .

See also

glyphRuns()

PySide6.QtGui.QTextLine.height()

Return type

float

Returns the line’s height. This is equal to ascent() + descent() if leading is not included. If leading is included, this equals to ascent() + descent() + leading() .

See also

ascent() descent() leading() setLeadingIncluded()

PySide6.QtGui.QTextLine.horizontalAdvance()

Return type

float

Returns the horizontal advance of the text. The advance of the text is the distance from its position to the next position at which text would naturally be drawn.

By adding the advance to the position of the text line and using this as the position of a second text line, you will be able to position the two lines side-by-side without gaps in-between.

PySide6.QtGui.QTextLine.isValid()

Return type

bool

Returns true if this text line is valid; otherwise returns false.

PySide6.QtGui.QTextLine.leading()

Return type

float

Returns the line’s leading.

See also

ascent() descent() height()

PySide6.QtGui.QTextLine.leadingIncluded()

Return type

bool

Returns true if positive leading is included into the line’s height; otherwise returns false.

By default, leading is not included.

See also

setLeadingIncluded()

PySide6.QtGui.QTextLine.lineNumber()

Return type

int

Returns the position of the line in the text engine.

PySide6.QtGui.QTextLine.naturalTextRect()

Return type

PySide6.QtCore.QRectF

Returns the rectangle covered by the line.

PySide6.QtGui.QTextLine.naturalTextWidth()

Return type

float

Returns the width of the line that is occupied by text. This is always <= to width() , and is the minimum width that could be used by layout() without changing the line break position.

PySide6.QtGui.QTextLine.position()

Return type

PySide6.QtCore.QPointF

Returns the line’s position relative to the text layout’s position.

See also

setPosition()

PySide6.QtGui.QTextLine.rect()

Return type

PySide6.QtCore.QRectF

Returns the line’s bounding rectangle.

See also

x() y() textLength() width()

PySide6.QtGui.QTextLine.setLeadingIncluded(included)

Parameters

included – bool

Includes positive leading into the line’s height if included is true; otherwise does not include leading.

By default, leading is not included.

Note that negative leading is ignored, it must be handled in the code using the text lines by letting the lines overlap.

See also

leadingIncluded()

PySide6.QtGui.QTextLine.setLineWidth(width)

Parameters

width – float

Lays out the line with the given width. The line is filled from its starting position with as many characters as will fit into the line. In case the text cannot be split at the end of the line, it will be filled with additional characters to the next whitespace or end of the text.

PySide6.QtGui.QTextLine.setNumColumns(columns)

Parameters

columns – int

Lays out the line. The line is filled from its starting position with as many characters as are specified by numColumns. In case the text cannot be split until numColumns characters, the line will be filled with as many characters to the next whitespace or end of the text.

PySide6.QtGui.QTextLine.setNumColumns(columns, alignmentWidth)

Parameters

• columns – int

• alignmentWidth – float

Lays out the line. The line is filled from its starting position with as many characters as are specified by numColumns. In case the text cannot be split until numColumns characters, the line will be filled with as many characters to the next whitespace or end of the text. The provided alignmentWidth is used as reference width for alignment.

PySide6.QtGui.QTextLine.setPosition(pos)

Parameters

pos – PySide6.QtCore.QPointF

Moves the line to position pos.

See also

position()

PySide6.QtGui.QTextLine.textLength()

Return type

int

Returns the length of the text in the line.

See also

naturalTextWidth()

PySide6.QtGui.QTextLine.textStart()

Return type

int

Returns the start of the line from the beginning of the string passed to the QTextLayout .

PySide6.QtGui.QTextLine.width()

Return type

float

Returns the line’s width as specified by the layout() function.

See also

naturalTextWidth() x() y() textLength() rect()

PySide6.QtGui.QTextLine.x()

Return type

float

Returns the line’s x position.

See also

rect() y() textLength() width()

PySide6.QtGui.QTextLine.xToCursor(x[, edge=QTextLine.CursorPosition.CursorBetweenCharacters])

Parameters

• x – float

• edge – CursorPosition

Return type

int

Converts the x-coordinate x, to the nearest matching cursor position, depending on the cursor position type, cpos. Note that result cursor position includes possible preedit area text.

See also

cursorToX()

PySide6.QtGui.QTextLine.y()

Return type

float

Returns the line’s y position.

See also

x() rect() textLength() width()