En esta página

TextMetrics QML Type

Proporciona métricas para una fuente y un texto determinados. Más...

Import Statement: import QtQuick

Propiedades

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:

ConstanteDescripción
Qt::ElideNoneNo elide; este es el valor por defecto.
Qt::ElideLeftPor ejemplo: "...Mundo"
Qt::ElideMiddlePor ejemplo "He...ld"
Qt::ElideRightPor 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:

ConstanteDescripción
TextEdit.QtRenderingEl texto se renderiza utilizando un campo de distancia escalable para cada glifo.
TextEdit.NativeRenderingEl 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.