En esta página

QTextLine Class

La clase QTextLine representa una línea de texto dentro de un objeto ` QTextLayout`. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

enum CursorPosition { CursorBetweenCharacters, CursorOnCharacter }
enum Edge { Leading, Trailing }

Funciones públicas

QTextLine()
qreal ascent() const
qreal cursorToX(int *cursorPos, QTextLine::Edge edge = Leading) const
qreal cursorToX(int cursorPos, QTextLine::Edge edge = Leading) const
qreal descent() const
void draw(QPainter *painter, const QPointF &position) const
(since 6.5) QList<QGlyphRun> glyphRuns(int from, int length, QTextLayout::GlyphRunRetrievalFlags retrievalFlags) const
QList<QGlyphRun> glyphRuns(int from = -1, int length = -1) const
qreal height() const
qreal horizontalAdvance() const
bool isValid() const
qreal leading() const
bool leadingIncluded() const
int lineNumber() const
QRectF naturalTextRect() const
qreal naturalTextWidth() const
QPointF position() const
QRectF rect() const
void setLeadingIncluded(bool included)
void setLineWidth(qreal width)
void setNumColumns(int numColumns)
void setNumColumns(int numColumns, qreal alignmentWidth)
void setPosition(const QPointF &pos)
int textLength() const
int textStart() const
qreal width() const
qreal x() const
int xToCursor(qreal x, QTextLine::CursorPosition cpos = CursorBetweenCharacters) const
qreal y() const

Descripción detallada

Una línea de texto suele crearse mediante la función ` QTextLayout::createLine()`.

Una vez creada, la línea se puede rellenar utilizando las funciones ` setLineWidth()` o ` setNumColumns()`. Una línea tiene una serie de atributos, entre los que se incluyen el rectángulo que ocupa, ` rect()`, sus coordenadas, ` x()` y ` y()`, su ` textLength()`, ` width()` y ` naturalTextWidth()`, y su ` ascent()` y ` descent()` en relación con el texto. La posición del cursor en relación con la línea se puede obtener mediante ` cursorToX()` y su inversa mediante ` xToCursor()`. Una línea se puede desplazar con ` setPosition()`.

Documentación sobre los tipos de miembros

enum QTextLine::CursorPosition

ConstanteValor
QTextLine::CursorBetweenCharacters0
QTextLine::CursorOnCharacter1

enum QTextLine::Edge

ConstanteValor
QTextLine::Leading0
QTextLine::Trailing1

Documentación de funciones de miembro

QTextLine::QTextLine()

Crea una línea no válida.

qreal QTextLine::ascent() const

Devuelve la elevación de la línea.

Véase también descent() y height().

qreal QTextLine::cursorToX(int *cursorPos, QTextLine::Edge edge = Leading) const

Convierte la posición del cursor cursorPos en la posición x correspondiente dentro de la línea, teniendo en cuenta el edge.

Si cursorPos no es una posición válida del cursor, se utilizará en su lugar la posición válida más cercana, y se modificará cursorPos para que apunte a dicha posición válida del cursor.

Véase también xToCursor().

qreal QTextLine::cursorToX(int cursorPos, QTextLine::Edge edge = Leading) const

Esta es una función sobrecargada.

qreal QTextLine::descent() const

Devuelve el descenso de la línea.

Véase también ` ascent()` y ` height()`.

void QTextLine::draw(QPainter *painter, const QPointF &position) const

Dibuja una línea en el punto dado painter en la posición especificada position.

[since 6.5] QList<QGlyphRun> QTextLine::glyphRuns(int from, int length, QTextLayout::GlyphRunRetrievalFlags retrievalFlags) const

Devuelve los índices y las posiciones de todos los glifos de este « QTextLine » para los caracteres comprendidos en el rango definido por « from » y « length ». El índice « from » es relativo al inicio del texto en el « QTextLayout » que lo contiene, y el rango debe estar comprendido dentro del rango de « QTextLine », tal y como lo establecen las funciones « textStart()» y « textLength()».

El parámetro « retrievalFlags » especifica qué propiedades del elemento « QGlyphRun » se recuperarán del diseño. Para minimizar las asignaciones y el consumo de memoria, se debe configurar de modo que incluya únicamente las propiedades a las que se vaya a acceder posteriormente.

Si from es negativo, se establecerá por defecto en textStart(), y si length es negativo, se establecerá por defecto en el valor de retorno de textLength().

Esta función se introdujo en Qt 6.5.

Véase también QTextLayout::glyphRuns().

QList<QGlyphRun> QTextLine::glyphRuns(int from = -1, int length = -1) const

Devuelve los índices y las posiciones de todos los glifos de este ` QTextLine ` para los caracteres comprendidos en el rango definido por ` from ` y ` length`. El índice ` from ` es relativo al inicio del texto en el ` QTextLayout` que lo contiene, y el rango debe estar comprendido dentro del rango de ` QTextLine `, tal y como lo establecen las funciones ` textStart()` y ` textLength()`.

Si ` from ` es negativo, se establecerá por defecto en ` textStart` (), y si ` length ` es negativo, se establecerá por defecto en el valor de retorno de ` textLength` ().

Nota: Esto equivale a llamar a glyphRuns(from, length, QTextLayout::GlyphRunRetrievalFlag::GlyphIndexes | QTextLayout::GlyphRunRetrievalFlag::GlyphPositions).

Se trata de una función sobrecargada.

Véase también QTextLayout::glyphRuns().

qreal QTextLine::height() const

Devuelve la altura de la línea. Es igual a ascent() + descent() si no se incluye el espacio inicial. Si se incluye el espacio inicial, es igual a ascent() + descent() + leading().

Véase también ascent(), descent(), leading() y setLeadingIncluded().

qreal QTextLine::horizontalAdvance() const

Devuelve el avance horizontal del texto. El avance del texto es la distancia entre su posición y la siguiente posición en la que el texto se dibujaría de forma natural.

Si sumas el avance a la posición de la línea de texto y utilizas este valor como posición de una segunda línea de texto, podrás colocar las dos líneas una al lado de la otra sin que queden espacios entre ellas.

bool QTextLine::isValid() const

Devuelve « true » si esta línea de texto es válida; en caso contrario, devuelve « false ».

qreal QTextLine::leading() const

Devuelve el sangrado de la línea.

Véase también ascent(), descent() y height().

bool QTextLine::leadingIncluded() const

Devuelve « true » si el espacio inicial positivo se incluye en la altura de la línea; en caso contrario, devuelve « false ».

Por defecto, el espacio inicial no se incluye.

Véase también setLeadingIncluded().

int QTextLine::lineNumber() const

Devuelve la posición de la línea en el motor de texto.

QRectF QTextLine::naturalTextRect() const

Devuelve el rectángulo que abarca la línea.

qreal QTextLine::naturalTextWidth() const

Devuelve la anchura de la línea ocupada por el texto. Este valor es siempre menor o igual que width(), y corresponde a la anchura mínima que podría utilizar la función layout() sin modificar la posición del salto de línea.

QPointF QTextLine::position() const

Devuelve la posición de la línea con respecto a la posición de la disposición del texto.

Véase también setPosition().

QRectF QTextLine::rect() const

Devuelve el rectángulo delimitador de la línea.

Véase también x(), y(), textLength() y width().

void QTextLine::setLeadingIncluded(bool included)

Incluye el espaciado superior en la altura de la línea si « included » es verdadero; en caso contrario, no incluye dicho espaciado.

Por defecto, no se incluye el interlineado.

Ten en cuenta que el interlineado negativo se ignora; debe gestionarse en el código que utiliza las líneas de texto haciendo que las líneas se superpongan.

Véase también leadingIncluded().

void QTextLine::setLineWidth(qreal width)

Coloca la línea con el texto dado width. La línea se rellena desde su posición inicial con tantos caracteres como quepan en ella. En caso de que el texto no pueda dividirse al final de la línea, se rellenará con caracteres adicionales hasta el siguiente espacio en blanco o hasta el final del texto.

void QTextLine::setNumColumns(int numColumns)

Formatea la línea. La línea se rellena desde su posición inicial con tantos caracteres como se especifiquen en ` numColumns`. En caso de que el texto no pueda dividirse hasta alcanzar ` numColumns ` caracteres, la línea se rellenará con tantos caracteres como sea posible hasta el siguiente espacio en blanco o hasta el final del texto.

void QTextLine::setNumColumns(int numColumns, qreal alignmentWidth)

Formatea la línea. La línea se rellena desde su posición inicial con tantos caracteres como se especifiquen en ` numColumns`. En caso de que el texto no pueda dividirse hasta alcanzar ` numColumns ` caracteres, la línea se rellenará con tantos caracteres como sea posible hasta el siguiente espacio en blanco o hasta el final del texto. El valor proporcionado en ` alignmentWidth ` se utiliza como ancho de referencia para la alineación.

void QTextLine::setPosition(const QPointF &pos)

Mueve la línea a la posición pos.

Véase también position().

int QTextLine::textLength() const

Devuelve la longitud del texto de la línea.

Véase también naturalTextWidth().

int QTextLine::textStart() const

Devuelve la posición del inicio de la línea desde el principio de la cadena pasada a la función ` QTextLayout`.

qreal QTextLine::width() const

Devuelve el ancho de la línea tal y como se especifica en la función layout().

Véase también naturalTextWidth(), x(), y(), textLength() y rect().

qreal QTextLine::x() const

Devuelve la posición x de la línea.

Véase también rect(), y(), textLength() y width().

int QTextLine::xToCursor(qreal x, QTextLine::CursorPosition cpos = CursorBetweenCharacters) const

Convierte la coordenada x x en la posición del cursor más cercana que coincida, dependiendo del tipo de posición del cursor, cpos. Ten en cuenta que la posición resultante del cursor incluye el posible texto del área de preedición.

Véase también cursorToX().

qreal QTextLine::y() const

Devuelve la posición y de la línea.

Véase también x(), rect(), textLength() y width().

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