이 페이지에서

FontMetrics QML Type

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

Import Statement: import QtQuick

속성

방법

상세 설명

FontMetrics는 지정된 글꼴에 대해 문자 및 문자열의 크기를 계산합니다.

이 함수는 C++ QFontMetricsF API의 하위 집합을 제공하며, font 속성을 통해 계산에 사용되는 글꼴을 변경할 수 있는 기능이 추가되어 있습니다.

FontMetrics {
    id: fontMetrics
    font.family: "Arial"
}

Rectangle {
    width: fontMetrics.height * 4
    height: fontMetrics.height * 2
}

QFontMetricsF 및 TextMetrics도 참조하십시오 .

속성 설명서

ascent : real [read-only]

이 속성은 글꼴의 상승량을 나타냅니다.

QFontMetricsF::ascent(), descent 및 height도 참조하십시오 .

averageCharacterWidth : real [read-only]

이 속성은 글꼴 내 글리프의 평균 너비를 나타냅니다.

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

capitalHeight : real [read-only, since 6.9]

글꼴에 지정된 대문자 높이를 반환합니다.

글꼴의 대문자 높이(cap-height)는 베이스라인 위의 대문자 높이로 정의됩니다. 이는 특히 H나 I와 같이 평평한 대문자의 높이를 가리키며, O와 같이 둥근 글자나 A와 같이 끝이 뾰족한 글자와는 구별됩니다. 둥근 글자나 뾰족한 글자의 경우 오버슈트가 발생할 수 있습니다.

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

QFontMetricsF::capHeight, ascent, descent, height 및 xHeight도 참조하십시오 .

descent : real [read-only]

이 속성은 글꼴의 하강을 나타냅니다.

QFontMetricsF::descent(), ascent 및 height도 참조하십시오 .

font : font

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

height : real [read-only]

이 속성은 글꼴의 높이를 나타냅니다.

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

leading : real [read-only]

이 속성은 글꼴의 행간을 지정합니다.

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

lineSpacing : real [read-only]

이 속성은 한 기준선에서 다음 기준선까지의 거리를 나타냅니다.

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

lineWidth : real [read-only]

이 속성은 글꼴의 포인트 크기에 맞춰 조정된 밑줄 및 취소선의 너비를 지정합니다.

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

maximumCharacterWidth : real [read-only]

이 속성은 글꼴에서 가장 넓은 문자의 너비를 저장합니다.

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

minimumLeftBearing : real [read-only]

이 속성은 글꼴의 최소 왼쪽 방위각을 나타냅니다.

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

minimumRightBearing : real [read-only]

이 속성은 글꼴의 최소 우측 방향을 나타냅니다.

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

overlinePosition : real [read-only]

이 속성은 기준선에서 위선(overline)이 그려져야 할 위치까지의 거리를 나타냅니다.

QFontMetricsF::overlinePos(), underlinePosition 및 strikeOutPosition도 참조하십시오 .

strikeOutPosition : real [read-only]

이 속성은 기준선에서 스트라이크아웃 라인이 그려져야 할 위치까지의 거리를 나타냅니다.

QFontMetricsF::strikeOutPos(), overlinePosition 및 underlinePosition도 참조하십시오 .

underlinePosition : real [read-only]

이 속성은 기준선에서 밑줄이 그려져야 할 위치까지의 거리를 지정합니다.

QFontMetricsF::underlinePos(), overlinePosition 및 strikeOutPosition도 참조하십시오 .

xHeight : real [read-only]

이 속성은 글꼴의 'x' 높이를 지정합니다.

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

메서드 문서

real advanceWidth(string text)

이 메서드는 ` text`에 포함된 문자열의 픽셀 단위 진척량을 반환합니다. 이는 문자열의 현재 위치에서 다음 문자열이 그려져야 할 위치까지의 거리입니다.

이 메서드는 ` TextMetrics`의 ` advanceWidth ` 속성에 대한 명령형 대안으로 제공됩니다.

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

rect boundingRect(string text)

이 메서드는 text 로 지정된 문자열 내의 문자들에 대한 경계 사각형을 반환합니다.

이 메서드는 ` TextMetrics`의 ` boundingRect ` 속성에 대한 명령형 대안으로 제공됩니다.

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

string elidedText(string text, enumeration mode, real width, int flags)

이 메서드는 문자열 text 의 너비가 width 보다 클 경우, 생략된 버전의 문자열(즉, “...”이 포함된 문자열)을 반환합니다. 그렇지 않은 경우, 원본 문자열을 반환합니다.

mode 인수는 텍스트 생략 모드를 지정합니다. 즉, 텍스트가 화면에 다 들어가지 않을 때 생략 부호가 표시될 위치를 지정합니다.

flags 인수는 선택 사항이며, 현재 Qt::TextShowMnemonic 만 지원합니다.

이 메서드는 TextMetrics 의 elidedText 속성에 대한 명령형 대안으로 제공됩니다.

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

rect tightBoundingRect(string text)

이 메서드는 text 로 지정된 문자열 내의 문자들을 둘러싼 꽉 찬 경계 사각형을 반환합니다.

이 메서드는 ` TextMetrics`의 ` tightBoundingRect ` 속성에 대한 명령형 대안으로 제공됩니다.

QFontMetricsF::tightBoundingRect() 및 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.