이 페이지에서

TextMetrics QML Type

지정된 글꼴 및 텍스트에 대한 메트릭 정보를 제공합니다. 더 보기...

Import Statement: import QtQuick

속성

상세 설명

TextMetrics는 특정 글꼴에 대해 주어진 텍스트 문자열의 다양한 속성을 계산합니다.

이 함수는 인수를 받는 QFontMetricsF 의 함수들에 대한 선언적 API를 제공합니다.

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

MyItem {
    text: textMetrics.elidedText
}

QFontMetricsF 및 FontMetrics도 참조하십시오 .

속성 문서

advanceWidth : real [read-only]

이 속성은 ` text` 내 문자열의 픽셀 단위 간격을 나타냅니다. 이는 문자열의 현재 위치에서 다음 문자열이 그려져야 할 위치까지의 거리입니다.

QFontMetricsF::horizontalAdvance()도 참조하십시오 .

boundingRect : rect [read-only]

이 속성은 text 로 지정된 문자열 내의 문자들에 대한 경계 사각형을 포함합니다.

QFontMetricsF::boundingRect() 및 tightBoundingRect도 참조하십시오 .

elide : enumeration

이 속성은 텍스트의 생략 모드를 나타냅니다. 이 속성은 문자열이 생략되는 위치를 결정합니다. 가능한 값은 다음과 같습니다:

상수설명
Qt::ElideNone생략 없음; 이는 기본값입니다.
Qt::ElideLeft예: "...World"
Qt::ElideMiddle예: "He...ld"
Qt::ElideRight예: "Hello..."

elideWidth 및 QFontMetrics::elidedText도 참조하십시오 .

elideWidth : real

이 속성은 텍스트가 생략되기 전에 가질 수 있는 최대 너비(픽셀 단위)를 지정합니다.

elide 및 QFontMetrics::elidedText도 참조하십시오 .

elidedText : string [read-only]

이 속성은 문자열 text 의 너비가 elideWidth 보다 클 경우, 해당 문자열의 생략된 버전(즉, "..."이 포함된 문자열)을 저장합니다. 텍스트의 너비가 elideWidth 보다 작거나, elide 가 Qt::ElideNone 로 설정된 경우, 이 속성은 원본 문자열과 동일합니다.

QFontMetricsF::elidedText()도 참조하십시오 .

font : font

이 속성은 메트릭 계산에 사용되는 글꼴을 저장합니다.

height : real [read-only]

이 속성은 text 로 지정된 문자열 내 문자들의 경계 사각형의 높이를 저장합니다. 이는 다음 코드와 동일합니다:

textMetrics.boundingRect.height

boundingRect도 참조하십시오 .

renderType : enumeration [since 6.3]

이 컴포넌트의 기본 렌더링 유형을 재정의합니다.

지원되는 렌더링 유형은 다음과 같습니다:

상수설명
TextEdit.QtRendering텍스트는 각 글리프에 대해 확장 가능한 거리 필드를 사용하여 렌더링됩니다.
TextEdit.NativeRendering텍스트는 플랫폼별 기법을 사용하여 렌더링됩니다.

이는 텍스트를 그릴 예정인 대상 renderType 과 일치해야 합니다.

이 속성은 Qt 6.3에서 도입되었습니다.

Text.renderType도 참조하십시오 .

text : string

이 속성은 지표 계산에 사용되는 텍스트를 포함합니다.

tightBoundingRect : rect [read-only]

이 속성은 text 로 지정된 문자열 내의 문자들을 둘러싸는 꽉 조인 경계 사각형을 유지합니다.

QFontMetricsF::tightBoundingRect() 및 boundingRect도 참조하십시오 .

width : real [read-only]

이 속성은 text 로 지정된 문자열 내 문자들의 경계 사각형의 너비를 저장합니다. 이는 다음과 동일합니다:

textMetrics.boundingRect.width

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.