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 diversas propiedades de una cadena de texto dada para una fuente concreta.
Proporciona una API declarativa para las funciones de QFontMetricsF que admiten 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 de « text ». Se trata de la distancia entre la posición de la cadena y el lugar 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 define el modo de elisión del texto. Determina la posición en la que se elide la cadena. Los valores posibles son:
| Constante | Descripción |
|---|---|
Qt::ElideNone | Sin elisión; este es el valor por defecto. |
Qt::ElideLeft | Por ejemplo: «...World» |
Qt::ElideMiddle | Por ejemplo: «He...ld» |
Qt::ElideRight | Por ejemplo: «Hello...» |
Véase también elideWidth y QFontMetrics::elidedText.
elideWidth : real
Esta propiedad establece la anchura máxima que puede tener el texto (en píxeles) antes de que se produzca la elisión.
Véase también elide y QFontMetrics::elidedText.
elidedText : string [read-only]
Esta propiedad contiene una versión abreviada de la cadena (es decir, una cadena que incluye «...») si la cadena text tiene una longitud mayor que elideWidth. Si el texto no supera la longitud de elideWidth, o si elide está establecido 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 métricos.
height : real [read-only]
Esta propiedad contiene la altura del rectángulo delimitador de los caracteres de la cadena especificada por text. Es equivalente a:
textMetrics.boundingRect.heightVéase también boundingRect.
renderType : enumeration [since 6.3]
Sobrescribir el tipo de representación predeterminado de este componente.
Los tipos de representación admitidos son:
| Constante | Descripción |
|---|---|
TextEdit.QtRendering | El texto se representa 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 debe coincidir con la « renderType » prevista en la que 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 que se utiliza para el cálculo de las métricas.
tightBoundingRect : rect [read-only]
Esta propiedad define un rectángulo delimitador ajustado alrededor de los caracteres de la cadena especificada por text.
Véase también ` QFontMetricsF::tightBoundingRect()` y ` boundingRect`.
width : real [read-only]
Esta propiedad contiene el ancho del rectángulo delimitador de los caracteres de la cadena especificada por text. Es equivalente a:
textMetrics.boundingRect.widthVé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.