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 |
- Lista de todos los miembros, incluidos los heredados
- QTextLine forma parte de las API de procesamiento de texto enriquecido.
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
| Constante | Valor |
|---|---|
QTextLine::CursorBetweenCharacters | 0 |
QTextLine::CursorOnCharacter | 1 |
enum QTextLine::Edge
| Constante | Valor |
|---|---|
QTextLine::Leading | 0 |
QTextLine::Trailing | 1 |
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.