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 |
- Lista de todos los miembros, incluidos los heredados
- QGlyphRun forma parte de las clases compartidas implícitamente.
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.
| Constante | Valor | Descripción |
|---|---|---|
QGlyphRun::Overline | 0x01 | Indica que los glifos deben visualizarse junto con una línea superior. |
QGlyphRun::Underline | 0x02 | Indica que los glifos deben visualizarse junto con un subrayado superior. |
QGlyphRun::StrikeOut | 0x04 | Indica que los glifos deben aparecer tachados visualmente. |
QGlyphRun::RightToLeft | 0x08 | Indica 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::SplitLigature | 0x10 | Indica 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.