TextMetrics QML 类型

提供针对给定字体和文本的度量数据。更多信息...

导入声明	import QtQuick

所有成员列表，包括继承的成员

属性

advanceWidth : 浮点数
boundingRect : 矩形
elide : 枚举
elideWidth : 浮点数
elidedText : 字符串
font : 字体
height : 浮点数
renderType : 枚举 (从 6.3 版本起)
text : 字符串
tightBoundingRect : 矩形
width : 浮点数

详细说明

TextMetrics 为特定字体中给定文本字符串计算各种属性。

它为 QFontMetricsF 中的函数提供声明式 API，这些函数接受参数。

TextMetrics {
    id: textMetrics
    font.family: "Arial"
    elide: Text.ElideMiddle
    elideWidth: 100
    text: "Hello World"
}

MyItem {
    text: textMetrics.elidedText
}

参见QFontMetricsF 和 FontMetrics。

属性文档

advanceWidth : float [只读]

此属性保留 text 中字符的进距。这是字符串位置到当前应绘制下一字符串的位置的距离。

参见QFontMetricsF::horizontalAdvance。

boundingRect : rect [只读]

此属性保留由 text 指定的字符串中字符的边界矩形。

参见QFontMetricsF::boundingRect() 和 tightBoundingRect。

elide : 枚举

此属性保留文本的裁剪模式。这决定了字符串被裁剪的位置。可能的值有

常量	描述
`Qt::ElideNone`	无裁剪；这是默认值。
`Qt::ElideLeft`	例如：“...世界”
`Qt::ElideMiddle`	例如：“他...们”
`Qt::ElideRight`	例如：“Hello...”

参见elideWidth 和 QFontMetrics::elidedText。

elideWidth : real

此属性存储文本可以拥有的最大宽度（以像素为单位），在发生收缩之前。

另请参阅elide和QFontMetrics::elidedText.

elidedText : string [只读]

如果字符串text比elideWidth更宽，则此属性包含字符串的收缩版本（即包含"..."的字符串）。如果没有更宽，或者elide设置为Qt::ElideNone，此属性将与原始字符串相等。

另请参阅QFontMetricsF::elidedText().

font : font

此属性包含用于指标计算的字体。

height : real [只读]

此属性包含由text指定的字符串中字符的边界矩形的宽度。它相当于

textMetrics.boundingRect.height

另请参阅boundingRect.

renderType : enumeration [自 6.3]

覆盖此组件的默认渲染类型。

支持的渲染类型包括

常量	描述
`TextEdit.QtRendering`	文本使用每个字形的可缩放距离场进行渲染。
`TextEdit.NativeRendering`	文本使用平台特定的技术进行渲染。

这应与您绘制文本的意图renderType相匹配。

此属性是在 Qt 6.3 中引入的。

另请参阅Text.renderType.

text : string

此属性包含用于指标计算的文本。

tightBoundingRect : rect [只读]

此属性包含由text指定的字符串中字符的紧密边界矩形。

另请参阅QFontMetricsF::tightBoundingRect()和boundingRect.

width : real [只读]

此属性包含由text指定的字符串中字符的边界矩形的宽度。它相当于

textMetrics.boundingRect.width

另请参阅boundingRect.