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 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:

ConstanteDescripción
Qt::ElideNoneSin elisión; este es el valor por defecto.
Qt::ElideLeftPor ejemplo: «...World»
Qt::ElideMiddlePor ejemplo: «He...ld»
Qt::ElideRightPor 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.height

Vé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:

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