TextMetrics QML Type

Provides metrics for a given font and text. 更多...

导入语句：

import QtQuick

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

特性

advanceWidth : real
boundingRect : rect
elide : enumeration
elideWidth : real
elidedText : string
font : font
height : real
renderType : enumeration
text : string
tightBoundingRect : rect
width : real

详细描述

TextMetrics calculates various properties of a given string of text for a particular font.

It provides a declarative API for the functions in QFontMetricsF which take arguments.

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

另请参阅 QFontMetricsF and FontMetrics .

特性文档编制

[read-only] advanceWidth : real

This property holds the advance in pixels of the characters in text . This is the distance from the position of the string to where the next string should be drawn.

另请参阅 QFontMetricsF::horizontalAdvance ().

[read-only] boundingRect : rect

This property holds the bounding rectangle of the characters in the string specified by text .

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

elide : enumeration

This property holds the elide mode of the text. This determines the position in which the string is elided. The possible values are:

常量	描述
`Qt::ElideNone`	No eliding; this is the default value.
`Qt::ElideLeft`	For example: "...World"
`Qt::ElideMiddle`	For example: "He...ld"
`Qt::ElideRight`	For example: "Hello..."

另请参阅 elideWidth and QFontMetrics::elidedText .

elideWidth : real

This property holds the largest width the text can have (in pixels) before eliding will occur.

另请参阅 elide and QFontMetrics::elidedText .

[read-only] elidedText : string

This property holds an elided version of the string (i.e., a string with "..." in it) if the string text 宽于 elideWidth . If the text is not wider than elideWidth ，或 elide 被设为 Qt::ElideNone , this property will be equal to the original string.

另请参阅 QFontMetricsF::elidedText ().

font : font

This property holds the font used for the metrics calculations.

[read-only] height : real

This property holds the height of the bounding rectangle of the characters in the string specified by text . It is equivalent to:

textMetrics.boundingRect.height

另请参阅 boundingRect .

[since 6.3] renderType : enumeration

Override the default rendering type for this component.

Supported render types are:

常量	描述
`TextEdit.QtRendering`	Text is rendered using a scalable distance field for each glyph.
`TextEdit.NativeRendering`	Text is rendered using a platform-specific technique.

This should match the intended renderType where you draw the text.

This property was introduced in Qt 6.3.

另请参阅 Text.renderType .

text : string

This property holds the text used for the metrics calculations.

[read-only] tightBoundingRect : rect

This property holds a tight bounding rectangle around the characters in the string specified by text .

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

[read-only] width : real

This property holds the width of the bounding rectangle of the characters in the string specified by text . It is equivalent to:

textMetrics.boundingRect.width

另请参阅 boundingRect .