En esta página

QGlyphRun Class

La clase QGlyphRun permite acceder directamente a los glifos internos de una fuente. Más información...

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

Tipos públicos

enum GlyphRunFlag { Overline, Underline, StrikeOut, RightToLeft, SplitLigature }
flags GlyphRunFlags

Funciones públicas

QGlyphRun()
QGlyphRun(const QGlyphRun &other)
~QGlyphRun()
QRectF boundingRect() const
void clear()
QGlyphRun::GlyphRunFlags flags() const
QList<quint32> glyphIndexes() const
bool isEmpty() const
bool isRightToLeft() const
bool overline() const
QList<QPointF> positions() const
QRawFont rawFont() const
void setBoundingRect(const QRectF &boundingRect)
void setFlag(QGlyphRun::GlyphRunFlag flag, bool enabled = true)
void setFlags(QGlyphRun::GlyphRunFlags flags)
void setGlyphIndexes(const QList<quint32> &glyphIndexes)
void setOverline(bool overline)
void setPositions(const QList<QPointF> &positions)
void setRawData(const quint32 *glyphIndexArray, const QPointF *glyphPositionArray, int size)
void setRawFont(const QRawFont &rawFont)
void setRightToLeft(bool rightToLeft)
(since 6.5) void setSourceString(const QString &sourceString)
void setStrikeOut(bool strikeOut)
(since 6.5) void setStringIndexes(const QList<qsizetype> &stringIndexes)
void setUnderline(bool underline)
(since 6.5) QString sourceString() const
bool strikeOut() const
(since 6.5) QList<qsizetype> stringIndexes() const
void swap(QGlyphRun &other)
bool underline() const
bool operator!=(const QGlyphRun &other) const
QGlyphRun &operator=(const QGlyphRun &other)
bool operator==(const QGlyphRun &other) const

Descripción detallada

Cuando Qt muestra una cadena de texto codificada en Unicode, primero convierte los puntos Unicode en una lista de índices de glifos y una lista de posiciones basadas en una o más fuentes. La representación Unicode del texto y el objeto ` QFont ` servirán en este caso como una abstracción práctica que oculta los detalles de lo que realmente ocurre al mostrar el texto en pantalla. Por ejemplo, para cuando el texto llegue realmente a la pantalla, puede que esté representado por un conjunto de fuentes además de la especificada por el usuario, por ejemplo, en caso de que la fuente seleccionada originalmente no admitiera todos los sistemas de escritura contenidos en el texto.

En determinadas circunstancias, puede resultar útil para un desarrollador de aplicaciones disponer de un mayor control de bajo nivel sobre qué glifos de una fuente específica se dibujan en pantalla. Este podría ser, por ejemplo, el caso de aplicaciones que utilizan un motor de fuentes externo y un modelador de texto junto con Qt. QGlyphRun proporciona una interfaz a los datos sin procesar necesarios para mostrar el texto en pantalla. Contiene una lista de índices de glifos, una posición para cada glifo y una fuente.

Es responsabilidad del usuario asegurarse de que la fuente seleccionada contenga realmente los índices de glifos proporcionados.

QTextLayout::glyphRunsSe pueden utilizar () o QTextFragment::glyphRuns() para convertir texto codificado en Unicode en una lista de objetos QGlyphRun, y QPainter::drawGlyphRun() para dibujar los glifos.

Nota: Tenga en cuenta que ` QRawFont ` se considera local al hilo en el que se construye. Esto significa, a su vez, que habrá que crear un nuevo ` QRawFont ` y asignarlo al `QGlyphRun` si este se traslada a un hilo diferente. Si el QGlyphRun contiene una referencia a un ` QRawFont ` de un hilo distinto al actual, no será posible dibujar los glifos utilizando un ` QPainter`, ya que el ` QRawFont ` se considera inválido e inaccesible en este caso.

Documentación sobre los tipos de miembro

enum QGlyphRun::GlyphRunFlag
flags QGlyphRun::GlyphRunFlags

Esta enumeración describe los indicadores que modifican la forma en que se puede presentar o comportar una secuencia de glifos en un diseño visual. El diseño que genera las secuencias de glifos puede establecer estos indicadores basándose en datos internos relevantes, con el fin de conservar la información necesaria para presentar el texto tal y como lo desea el usuario del diseño.

ConstanteValorDescripción
QGlyphRun::Overline0x01Indica que los glifos deben visualizarse junto con una línea superior.
QGlyphRun::Underline0x02Indica que los glifos deben visualizarse junto con un subrayado superior.
QGlyphRun::StrikeOut0x04Indica que los glifos deben aparecer tachados visualmente.
QGlyphRun::RightToLeft0x08Indica que los glifos se ordenan de derecha a izquierda. Esto puede afectar a la posición de otros elementos de la pantalla que son relativos a la secuencia de glifos, como un objeto de texto en línea.
QGlyphRun::SplitLigature0x10Indica que la secuencia de glifos divide un glifo de ligadura. Esto significa que se incluye un glifo de ligadura en la secuencia, pero los caracteres que representa corresponden solo a una parte de dicha ligadura. En este caso, la función ` boundingRect()` de la secuencia de glifos puede utilizarse para recuperar el área cubierta por los glifos que corresponden a los caracteres representados por la secuencia. Al visualizar los glifos, hay que tener cuidado de recortar según este rectángulo delimitador para garantizar que solo se dibuje la parte correspondiente de la ligadura. En particular, esto puede ocurrir al recuperar una secuencia de glifos de un ` QTextLayout ` para un rango de caracteres específico, por ejemplo, al recuperar el área seleccionada de un ` QTextLayout`.

El tipo GlyphRunFlags es un typedef para QFlags<GlyphRunFlag>. Almacena una combinación OR de valores de GlyphRunFlag.

Documentación de las funciones miembro

QGlyphRun::QGlyphRun()

Crea un objeto QGlyphRun vacío.

QGlyphRun::QGlyphRun(const QGlyphRun &other)

Crea un objeto `QGlyphRun` que es una copia de ` other`.

[noexcept] QGlyphRun::~QGlyphRun()

Destruye el « QGlyphRun ».

QRectF QGlyphRun::boundingRect() const

Devuelve el rectángulo más pequeño que contiene todos los glifos de este ` QGlyphRun`. Si se ha establecido un rectángulo delimitador mediante ` setBoundingRect()` (), se devolverá este. De lo contrario, el rectángulo delimitador se calculará en función de las métricas tipográficas de los glifos de la secuencia de glifos.

Véase también setBoundingRect().

void QGlyphRun::clear()

Borra todos los datos del objeto « QGlyphRun ».

QGlyphRun::GlyphRunFlags QGlyphRun::flags() const

Devuelve los indicadores establecidos para este ` QGlyphRun`.

Véase también « setFlags()» y « setFlag()».

QList<quint32> QGlyphRun::glyphIndexes() const

Devuelve los índices de glifos de este objeto ` QGlyphRun `.

Véase también setGlyphIndexes() y setPositions().

bool QGlyphRun::isEmpty() const

Devuelve ` true ` si ` QGlyphRun ` no contiene ningún glifo.

bool QGlyphRun::isRightToLeft() const

Devuelve ` true ` si este ` QGlyphRun ` contiene glifos que se dibujan de derecha a izquierda.

Véase también setRightToLeft() y flags().

bool QGlyphRun::overline() const

Devuelve ` true ` si este ` QGlyphRun ` debe pintarse con una decoración de línea superior.

Véase también setOverline() y flags().

QList<QPointF> QGlyphRun::positions() const

Devuelve la posición del borde de la línea de base de cada glifo de este conjunto de índices de glifos.

Véase también setPositions().

QRawFont QGlyphRun::rawFont() const

Devuelve la fuente seleccionada para este objeto ` QGlyphRun `.

Véase también ` setRawFont()`.

void QGlyphRun::setBoundingRect(const QRectF &boundingRect)

Establece el rectángulo delimitador de los glifos de esta secuencia de glifos ( QGlyphRun ) como boundingRect. Este rectángulo será el que devuelva la función « boundingRect()», a menos que sea nulo; en ese caso, se devolverá en su lugar el rectángulo delimitador de los glifos de la secuencia de glifos.

Nota: A menos que estés implementando el modelado de texto, no deberías tener que utilizar esta función. Se utiliza específicamente cuando la « QGlyphRun » debe representar un área más pequeña que el área de los glifos que contiene. Esto podría ocurrir, por ejemplo, si la secuencia de glifos se recupera llamando a QTextLayout::glyphRuns() y el rango especificado solo incluye parte de una ligatura (en la que se combinan dos o más caracteres en un único glifo). En tal caso, el rectángulo delimitador solo debe incluir la parte correspondiente del glifo de la ligatura, basándose en un cálculo del ancho medio de los caracteres que la componen.

Para dar soporte a este tipo de casos (un ejemplo son las selecciones que deben dibujarse con un color diferente al del texto principal), es necesario recortar el mecanismo de dibujo al rectángulo devuelto por boundingRect() para evitar dibujar todo el glifo de la ligadura.

Véase también boundingRect().

void QGlyphRun::setFlag(QGlyphRun::GlyphRunFlag flag, bool enabled = true)

Si enabled es verdadero, entonces flag está activado; en caso contrario, está desactivado.

Véase también flags() y setFlags().

void QGlyphRun::setFlags(QGlyphRun::GlyphRunFlags flags)

Establece los indicadores de este QGlyphRun en flags.

Véase también setFlag() y flags().

void QGlyphRun::setGlyphIndexes(const QList<quint32> &glyphIndexes)

Establece los índices de glifos de este objeto QGlyphRun en glyphIndexes. Los índices de glifos deben ser válidos para la fuente seleccionada.

Véase también glyphIndexes().

void QGlyphRun::setOverline(bool overline)

Indica que este QGlyphRun debe pintarse con una decoración de línea superior si overline es verdadero. De lo contrario, el QGlyphRun debe pintarse sin decoración de línea superior.

Véase también overline(), setFlag() y setFlags().

void QGlyphRun::setPositions(const QList<QPointF> &positions)

Establece las posiciones del borde de la línea de base de cada glifo de este conjunto de índices de glifos en positions.

Véase también positions().

void QGlyphRun::setRawData(const quint32 *glyphIndexArray, const QPointF *glyphPositionArray, int size)

Establece los índices y las posiciones de los glifos de este ` QGlyphRun ` para que utilice los primeros ` size ` elementos de las matrices ` glyphIndexArray ` y ` glyphPositionArray`. Los datos no se copian. El usuario que realiza la llamada debe garantizar que las matrices no se eliminen mientras exista este ` QGlyphRun ` y cualquier copia del mismo.

Véase también setGlyphIndexes() y setPositions().

void QGlyphRun::setRawFont(const QRawFont &rawFont)

Establece la fuente en la que se buscarán los índices de glifos según lo especificado en rawFont.

Véase también rawFont() y setGlyphIndexes().

void QGlyphRun::setRightToLeft(bool rightToLeft)

Indica que este ` QGlyphRun ` contiene glifos que deben ordenarse de derecha a izquierda si ` rightToLeft ` es verdadero. En caso contrario, se supone que el orden de los glifos es de izquierda a derecha.

Véase también isRightToLeft(), setFlag() y setFlags().

[since 6.5] void QGlyphRun::setSourceString(const QString &sourceString)

Establece la cadena correspondiente a la secuencia de glifos en ` sourceString`. Si se establece, los índices devueltos por ` stringIndexes()` deben ser índices de esta cadena.

Esta función se introdujo en Qt 6.5.

Véanse también sourceString() y stringIndexes().

void QGlyphRun::setStrikeOut(bool strikeOut)

Indica que este QGlyphRun debe representarse con un estilo de tachado si strikeOut es verdadero. De lo contrario, el QGlyphRun debe representarse sin estilo de tachado.

Véanse también strikeOut(), setFlag() y setFlags().

[since 6.5] void QGlyphRun::setStringIndexes(const QList<qsizetype> &stringIndexes)

Establece la lista de índices de cadenas correspondientes a los índices de glifos en stringIndexes

Consulte stringIndexes() para obtener más detalles sobre las convenciones de esta lista.

Esta función se introdujo en Qt 6.5.

Véase también stringIndexes() y sourceString().

void QGlyphRun::setUnderline(bool underline)

Indica que este « QGlyphRun » debe representarse con un subrayado si « underline » es verdadero. De lo contrario, el « QGlyphRun » debe representarse sin subrayado.

Véase también underline(), setFlag() y setFlags().

[since 6.5] QString QGlyphRun::sourceString() const

Devuelve la cadena correspondiente a la secuencia de glifos, si dicha secuencia se ha creado a partir de una cadena y esta se ha solicitado desde el diseño.

Esta función se introdujo en Qt 6.5.

Véase también setSourceString(), stringIndexes() y QTextLayout::glyphRuns().

bool QGlyphRun::strikeOut() const

Devuelve ` true ` si este ` QGlyphRun ` debe representarse con un efecto tachado.

Véase también setStrikeOut() y flags().

[since 6.5] QList<qsizetype> QGlyphRun::stringIndexes() const

Devuelve los índices de cadena correspondientes a cada índice de glifo, si la secuencia de glifos se ha construido a partir de una cadena y se han solicitado los índices de cadena al diseño. En este caso, la longitud del vector devuelto se corresponderá con la longitud de ` glyphIndexes()`. En los demás casos, estará vacío.

Dado que un solo glifo puede corresponder a varios caracteres de la cadena de origen, puede haber huecos en la lista de índices de cadena. Por ejemplo, si la cadena «first» es procesada por una fuente que contiene una ligadura para el par de caracteres «fi», entonces la cadena de cinco caracteres generará una secuencia de glifos compuesta por solo cuatro glifos. En ese caso, los índices de glifos podrían ser (1, 2, 3, 4) (cuatro índices de glifos arbitrarios), mientras que los índices de la cadena serían (0, 2, 3, 4). Los glifos siguen el orden lógico de la cadena, por lo que se sobreentiende que, en este caso, los primeros glifos abarcan los caracteres 0 y 1.

A la inversa, un solo carácter también puede generar varios glifos, en cuyo caso habrá entradas duplicadas en la lista de índices de cadena.

Los índices de cadena se corresponden con la cadena, a la que se puede acceder opcionalmente mediante ` sourceString()`.

Esta función se introdujo en Qt 6.5.

Véanse también setStringIndexes(), sourceString() y QTextLayout::glyphRuns().

[noexcept] void QGlyphRun::swap(QGlyphRun &other)

Cambia esta instancia de la secuencia de glifos por other. Esta operación es muy rápida y nunca falla.

bool QGlyphRun::underline() const

Devuelve ` true ` si este ` QGlyphRun ` debe pintarse con una decoración de subrayado.

Véase también setUnderline() y flags().

bool QGlyphRun::operator!=(const QGlyphRun &other) const

Compara other con este objeto QGlyphRun. Devuelve true si alguno de los índices de glifos, la lista de posiciones o la fuente son diferentes; en caso contrario, devuelve false.

QGlyphRun &QGlyphRun::operator=(const QGlyphRun &other)

Asigna « other » a este objeto « QGlyphRun ».

bool QGlyphRun::operator==(const QGlyphRun &other) const

Compara other con este objeto QGlyphRun. Devuelve true si la lista de índices de glifos, la lista de posiciones y la fuente son iguales; en caso contrario, devuelve false.

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