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 caracteres y cadenas para una fuente dada.
Proporciona 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 propiedades
ascent : real [read-only]
Esta propiedad mantiene el ascenso de la fuente.
Véase también QFontMetricsF::ascent(), descent, y height.
averageCharacterWidth : real [read-only]
Esta propiedad contiene la anchura media de los glifos de la fuente.
Véase también QFontMetricsF::averageCharWidth().
capitalHeight : real [read-only, since 6.9]
Devuelve la altura de mayúsculas especificada por la fuente.
La altura de mayúsculas 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 que son planas - como la H o la I - en contraposición a las letras redondas como la O, o puntiagudas como la A, ambas de las cuales pueden mostrar rebasamiento.
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 contiene la descendencia de la fuente.
Véase también QFontMetricsF::descent(), ascent, y height.
font : font
Esta propiedad contiene la fuente utilizada para los cálculos de las métricas.
height : real [read-only]
Esta propiedad contiene la altura de la fuente.
Véase también QFontMetricsF::height().
leading : real [read-only]
Esta propiedad contiene la dirección de la fuente.
Véase también QFontMetricsF::leading().
lineSpacing : real [read-only]
Esta propiedad mantiene la distancia de una línea base a la siguiente.
Véase también QFontMetricsF::lineSpacing().
lineWidth : real [read-only]
Esta propiedad contiene el ancho de las líneas de subrayado y tachado, ajustado al tamaño de punto de la fuente.
Véase también QFontMetricsF::lineWidth().
maximumCharacterWidth : real [read-only]
Esta propiedad contiene la anchura del carácter más ancho de la fuente.
Véase también QFontMetricsF::maxWidth().
minimumLeftBearing : real [read-only]
Esta propiedad mantiene el rumbo izquierdo mínimo de la fuente.
Véase también QFontMetricsF::minLeftBearing().
minimumRightBearing : real [read-only]
Esta propiedad mantiene el mínimo cojinete derecho de la fuente.
Véase también QFontMetricsF::minRightBearing().
overlinePosition : real [read-only]
Esta propiedad contiene la distancia desde la línea base hasta donde debe dibujarse una sobrelínea.
Véase también QFontMetricsF::overlinePos(), underlinePosition, y strikeOutPosition.
strikeOutPosition : real [read-only]
Esta propiedad contiene la distancia desde la línea base hasta donde debe dibujarse la línea de strikeout.
Véase también QFontMetricsF::strikeOutPos(), overlinePosition, y underlinePosition.
underlinePosition : real [read-only]
Esta propiedad contiene la distancia desde la línea base hasta donde debe dibujarse un guión bajo.
Véase también QFontMetricsF::underlinePos(), overlinePosition, y strikeOutPosition.
xHeight : real [read-only]
Esta propiedad contiene 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 en text. Es la distancia desde la posición de la cadena hasta donde debe dibujarse la siguiente cadena.
Este método se ofrece como 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 por 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 elidida de la cadena (es decir, una cadena con "..." dentro) si la cadena text es más ancha que width. En caso contrario, devuelve la cadena original.
El argumento mode especifica el modo de elidir texto; es decir, dónde debe aparecer la elipsis cuando se muestra texto que no cabe.
El argumento flags es opcional y actualmente sólo 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 ceñido 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éase 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.