Synopsis#

Methods#

def __init__()
def ascent()
def cursorToX()
def descent()
def draw()
def glyphRuns()
def height()
def horizontalAdvance()
def isValid()
def leading()
def leadingIncluded()
def lineNumber()
def naturalTextRect()
def naturalTextWidth()
def position()
def rect()
def setLeadingIncluded()
def setLineWidth()
def setNumColumns()
def setPosition()
def textLength()
def textStart()
def width()
def x()
def xToCursor()
def y()

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#

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 Edge#

Constant	Description
QTextLine.Leading
QTextLine.Trailing

class CursorPosition#

Constant	Description
QTextLine.CursorBetweenCharacters
QTextLine.CursorOnCharacter

__init__()#

Creates an invalid line.

ascent()#

Return type:: float

Returns the line’s ascent.

See also

descent() height()

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

Parameters:

cursorPos – int
edge – Edge

Return type:

PyObject

This is an overloaded function.

descent()#

Return type:: float

Returns the line’s descent.

See also

ascent() height()

draw(painter, position)#

Parameters:

painter – QPainter
position – QPointF

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

glyphRuns([from=-1[, length=-1]])#

Parameters:

from – int
length – int

Return type:

.list of QGlyphRun

This is an overloaded function.

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() .

Note

This is equivalent to calling glyphRuns (from, length, QTextLayout::GlyphRunRetrievalFlag::GlyphIndexes | QTextLayout::GlyphRunRetrievalFlag::GlyphPositions).