FontMetrics QML Type
Proporciona métricas para una fuente determinada. Más...
| Import Statement: | import QtQuick |
Propiedades
- ascent : real
- averageCharacterWidth : real
- capitalHeight : real
(since 6.9) - descent : real
- font : font
- height : real
- leading : real
- lineSpacing : real
- lineWidth : real
- maximumCharacterWidth : real
- minimumLeftBearing : real
- minimumRightBearing : real
- overlinePosition : real
- strikeOutPosition : real
- underlinePosition : real
- xHeight : real
Métodos
- real advanceWidth(string text)
- rect boundingRect(string text)
- string elidedText(string text, enumeration mode, real width, int flags)
- rect tightBoundingRect(string text)
Descripción detallada
FontMetrics calcula el tamaño de los caracteres y las cadenas para una fuente determinada.
Ofrece un subconjunto de la API de C++ QFontMetricsF, con la capacidad añadida de cambiar la fuente que se utiliza para los cálculos a través de la propiedad font.
FontMetrics {
id: fontMetrics
font.family: "Arial"
}
Rectangle {
width: fontMetrics.height * 4
height: fontMetrics.height * 2
}Véase también QFontMetricsF y TextMetrics.
Documentación de la propiedad
ascent : real [read-only]
Esta propiedad define la altura de la fuente.
Véase también QFontMetricsF::ascent(), descent y height.
averageCharacterWidth : real [read-only]
Esta propiedad contiene el ancho medio de los glifos de la fuente.
Véase también QFontMetricsF::averageCharWidth().
capitalHeight : real [read-only, since 6.9]
Devuelve la altura de las mayúsculas tal y como la especifica la fuente.
La altura de mayúscula de una fuente se define como la altura de una letra mayúscula por encima de la línea de base. Se refiere específicamente a la altura de las letras mayúsculas planas —como la H o la I— en contraposición a las letras redondeadas, como la O, o las letras puntiagudas, como la A, las cuales pueden mostrar un saliente.
Esta propiedad se introdujo en Qt 6.9.
Véase también QFontMetricsF::capHeight, ascent, descent, height y xHeight.
descent : real [read-only]
Esta propiedad determina el descenso de la fuente.
Véanse también QFontMetricsF::descent(), ascent y height.
font : font
Esta propiedad contiene la fuente utilizada para los cálculos de métricas.
height : real [read-only]
Esta propiedad indica la altura de la fuente.
Véase también QFontMetricsF::height().
leading : real [read-only]
Esta propiedad controla el espaciado entre letras de la fuente.
Véase también QFontMetricsF::leading().
lineSpacing : real [read-only]
Esta propiedad indica la distancia entre una línea de base y la siguiente.
Véase también QFontMetricsF::lineSpacing().
lineWidth : real [read-only]
Esta propiedad establece el ancho de las líneas de subrayado y tachado, ajustado al tamaño en puntos de la fuente.
Véase también QFontMetricsF::lineWidth().
maximumCharacterWidth : real [read-only]
Esta propiedad indica el ancho del carácter más ancho de la fuente.
Véase también QFontMetricsF::maxWidth().
minimumLeftBearing : real [read-only]
Esta propiedad indica el margen mínimo izquierdo de la fuente.
Véase también QFontMetricsF::minLeftBearing().
minimumRightBearing : real [read-only]
Esta propiedad establece el ángulo mínimo de inclinación hacia la derecha de la fuente.
Véase también QFontMetricsF::minRightBearing().
overlinePosition : real [read-only]
Esta propiedad indica la distancia desde la línea de base hasta el punto en el que debe trazarse una línea superior.
Véase también QFontMetricsF::overlinePos(), underlinePosition y strikeOutPosition.
strikeOutPosition : real [read-only]
Esta propiedad indica la distancia desde la línea de base hasta el punto en el que debe trazarse la línea de strikeout.
Véase también QFontMetricsF::strikeOutPos(), overlinePosition y underlinePosition.
underlinePosition : real [read-only]
Esta propiedad indica la distancia desde la línea de base hasta el punto en el que debe dibujarse un guión bajo.
Véase también QFontMetricsF::underlinePos(), overlinePosition y strikeOutPosition.
xHeight : real [read-only]
Esta propiedad establece la altura «x» de la fuente.
Véase también QFontMetricsF::xHeight().
Documentación del método
real advanceWidth(string text)
Este método devuelve el avance en píxeles de los caracteres de text. Se trata de la distancia entre la posición de la cadena y el lugar donde debe dibujarse la siguiente cadena.
Este método se ofrece como una alternativa imperativa a la propiedad ` advanceWidth ` de ` TextMetrics`.
Véase también QFontMetricsF::horizontalAdvance() y QFontMetricsF::height().
rect boundingRect(string text)
Este método devuelve el rectángulo delimitador de los caracteres de la cadena especificada mediante ` text`.
Este método se ofrece como alternativa imperativa a la propiedad ` boundingRect ` de ` TextMetrics`.
Véase también QFontMetricsF::boundingRect() y tightBoundingRect().
string elidedText(string text, enumeration mode, real width, int flags)
Este método devuelve una versión abreviada de la cadena (es decir, una cadena que contiene «...») si la cadena text tiene más caracteres que width. En caso contrario, devuelve la cadena original.
El argumento mode especifica el modo de elisión del texto; es decir, dónde deben aparecer los puntos suspensivos al mostrar texto que no cabe.
El argumento flags es opcional y, actualmente, solo admite Qt::TextShowMnemonic.
Este método se ofrece como alternativa imperativa a la propiedad elidedText de TextMetrics.
Véase también ` Qt::TextElideMode ` y ` QFontMetricsF::elidedText()`.
rect tightBoundingRect(string text)
Este método devuelve un rectángulo delimitador ajustado alrededor de los caracteres de la cadena especificada por ` text`.
Este método se ofrece como alternativa imperativa a la propiedad tightBoundingRect de TextMetrics.
Véanse también QFontMetricsF::tightBoundingRect() y boundingRect().
© 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.