TextMetrics QML Type
Proporciona métricas para una fuente y un texto determinados. Más...
| Import Statement: | import QtQuick |
Propiedades
- advanceWidth : real
- boundingRect : rect
- elide : enumeration
- elideWidth : real
- elidedText : string
- font : font
- height : real
- renderType : enumeration
(since 6.3) - text : string
- tightBoundingRect : rect
- width : real
Descripción detallada
TextMetrics calcula varias propiedades de una cadena de texto dada para una fuente determinada.
Proporciona una API declarativa para las funciones de QFontMetricsF que toman argumentos.
TextMetrics {
id: textMetrics
font.family: "Arial"
elide: Text.ElideMiddle
elideWidth: 100
text: "Hello World"
}
MyItem {
text: textMetrics.elidedText
}Véase también QFontMetricsF y FontMetrics.
Documentación de propiedades
advanceWidth : real [read-only]
Esta propiedad contiene 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.
Véase también QFontMetricsF::horizontalAdvance().
boundingRect : rect [read-only]
Esta propiedad contiene el rectángulo delimitador de los caracteres de la cadena especificada por text.
Véase también QFontMetricsF::boundingRect() y tightBoundingRect.
elide : enumeration
Esta propiedad contiene el modo de elidir del texto. Determina la posición en la que se elide la cadena. Los valores posibles son:
| Constante | Descripción |
|---|---|
Qt::ElideNone | No elide; este es el valor por defecto. |
Qt::ElideLeft | Por ejemplo: "...Mundo" |
Qt::ElideMiddle | Por ejemplo "He...ld" |
Qt::ElideRight | Por ejemplo: "Hola..." |
Véase también elideWidth y QFontMetrics::elidedText.
elideWidth : real
Esta propiedad contiene la anchura máxima que puede tener el texto (en píxeles) antes de que se produzca el elidido.
Véase también elide y QFontMetrics::elidedText.
elidedText : string [read-only]
Esta propiedad contiene una versión elidida de la cadena (es decir, una cadena con "..." en ella) si la cadena text es más ancha que elideWidth. Si el texto no es más ancho que elideWidth, o elide se establece en Qt::ElideNone, esta propiedad será igual a la cadena original.
Véase también QFontMetricsF::elidedText().
font : font
Esta propiedad contiene la fuente utilizada para los cálculos de las métricas.
height : real [read-only]
Esta propiedad mantiene la altura del rectángulo delimitador de los caracteres de la cadena especificada por text. Es equivalente a
textMetrics.boundingRect.height
Véase también boundingRect.
renderType : enumeration [since 6.3]
Anula el tipo de renderizado por defecto de este componente.
Los tipos de representación soportados son:
| Constante | Descripción |
|---|---|
TextEdit.QtRendering | El texto se renderiza utilizando un campo de distancia escalable para cada glifo. |
TextEdit.NativeRendering | El texto se representa utilizando una técnica específica de la plataforma. |
Esto debería coincidir con el renderType previsto donde se dibuja el texto.
Esta propiedad se introdujo en Qt 6.3.
Véase también Text.renderType.
text : string
Esta propiedad contiene el texto utilizado para los cálculos de las métricas.
tightBoundingRect : rect [read-only]
Esta propiedad mantiene un rectángulo ceñido alrededor de los caracteres de la cadena especificada por text.
Véase también QFontMetricsF::tightBoundingRect() y boundingRect.
width : real [read-only]
Esta propiedad mantiene la anchura del rectángulo delimitador de los caracteres de la cadena especificada por text. Es equivalente a
textMetrics.boundingRect.width
Véase también 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.