QFontMetricsF Class

QFont font("times", 24);
QFontMetricsF fm(font);
qreal pixelsWide = fm.horizontalAdvance("What's the advance width of this text?");
qreal pixelsHigh = fm.height();

멤버 함수 문서

[explicit] QFontMetricsF::QFontMetricsF(const QFont &font)

font 에 대한 글꼴 메트릭 객체를 생성합니다.

폰트 메트릭은 font 을 만드는 데 사용된 페인트 장치와 호환됩니다.

폰트 메트릭 객체는 생성 시 생성자에서 전달된 폰트에 대한 정보를 보유하며, 나중에 폰트의 속성이 변경되어도 업데이트되지 않습니다.

특정 페인트 장치와 호환되는 글꼴 메트릭을 가져오려면 QFontMetricsF(const QFont &, QPaintDevice *)를 사용하세요.

QFontMetricsF::QFontMetricsF(const QFontMetrics &fontMetrics)

주어진 fontMetrics 객체에서 부동 소수점 정밀도로 글꼴 메트릭 객체를 구축합니다.

QFontMetricsF::QFontMetricsF(const QFont &font, const QPaintDevice *paintdevice)

font 및 paintdevice 에 대한 글꼴 메트릭 객체를 생성합니다.

폰트 메트릭은 전달된 페인트 장치와 호환됩니다. paintdevice 이 nullptr 인 경우 메트릭은 화면 호환성, 즉 QPicture 또는 QPrinter 이 아닌 widgets 또는 pixmaps 에서 텍스트를 그리는 데 글꼴을 사용하는 경우 얻을 수 있는 메트릭이 됩니다.

글꼴 메트릭 객체는 생성 시 생성자에서 전달된 글꼴에 대한 정보를 보유하며, 나중에 글꼴의 속성이 변경되더라도 업데이트되지 않습니다.

QFontMetricsF::QFontMetricsF(const QFontMetricsF &fm)

fm 의 복사본을 생성합니다.

[noexcept] QFontMetricsF::~QFontMetricsF()

글꼴 메트릭 객체를 삭제하고 할당된 모든 리소스를 해제합니다.

qreal QFontMetricsF::ascent() const

글꼴의 고저를 반환합니다.

글꼴의 고저는 기준선으로부터 문자가 확장되는 가장 높은 위치까지의 거리입니다. 실제로 일부 글꼴 디자이너는 문자 위에 두 개 이상의 악센트를 넣거나 특정 문자를 수용하기 위해 이 규칙을 어기는 경우가 있으므로 이 값이 너무 작을 수 있습니다(드물지만).

descent()도 참조하세요 .

qreal QFontMetricsF::averageCharWidth() const

글꼴의 글리프 평균 너비를 반환합니다.

QRectF QFontMetricsF::boundingRect(QChar ch) const

기준선의 가장 왼쪽 점을 기준으로 ch 문자의 경계 사각형을 반환합니다.

경계 사각형은 이탤릭체 글꼴의 경우 (0, 0)의 왼쪽으로 확장될 수 있으며, 텍스트 출력은 경계 사각형의 모든 픽셀을 포함할 수 있다는 점에 유의하세요.

직사각형은 일반적으로 기준선 위와 아래로 모두 확장된다는 점에 유의하세요.

horizontalAdvance()도 참조하세요 .

QRectF QFontMetricsF::boundingRect(const QString &text) const

text 에 지정된 문자열에 있는 문자의 경계 사각형을 반환합니다. 경계 사각형은 항상 (0, 0)에 그려질 경우 텍스트가 포함할 픽셀 집합 이상을 포함합니다.

예를 들어 이탤릭체 글꼴의 경우 경계 사각형이 (0, 0)의 왼쪽으로 확장될 수 있으며 반환되는 사각형의 너비가 horizontalAdvance() 메서드가 반환하는 너비와 다를 수 있다는 점에 유의하세요.

문자열의 앞쪽 너비를 알고 싶다면(문자열 세트를 나란히 배치하기 위해) horizontalAdvance()를 대신 사용하세요.

줄 바꿈 문자는 줄 바꿈이 아닌 일반 문자로 처리됩니다.

경계 사각형의 높이는 height()에서 반환된 값만큼 커야 합니다.

horizontalAdvance(), height() 및 QPainter::boundingRect()도 참조하세요 .

[since 6.3] QRectF QFontMetricsF::boundingRect(const QString &text, const QTextOption &option) const

option 을 사용하여 레이아웃된 text 으로 지정된 문자열에 있는 문자의 경계 사각형을 반환합니다. 경계 사각형은 항상 (0, 0)에 그릴 경우 텍스트가 포함할 픽셀 세트 이상을 포함합니다.

예를 들어 이탤릭체 글꼴의 경우 경계 사각형이 (0, 0)의 왼쪽으로 확장될 수 있으며 반환된 사각형의 너비가 horizontalAdvance() 메서드가 반환하는 너비와 다를 수 있다는 점에 유의하세요.

문자열의 앞쪽 너비를 알고 싶다면(문자열 세트를 나란히 배치하기 위해) horizontalAdvance()를 대신 사용하세요.

줄 바꿈 문자는 줄 바꿈이 아닌 일반 문자로 처리됩니다.

경계 사각형의 높이는 height()에서 반환된 값만큼 커야 합니다.

이 함수는 Qt 6.3에 도입되었습니다.

horizontalAdvance(), height() 및 QPainter::boundingRect()도 참조하십시오 .

QRectF QFontMetricsF::boundingRect(const QRectF &rect, int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

이 함수는 오버로드된 함수입니다.

주어진 text 에 있는 문자의 경계 사각형을 반환합니다. 이것은 rect 에 지정된 경계 사각형으로 제한될 때 텍스트가 그려질 경우 텍스트가 덮을 픽셀 집합입니다. rect 가 nullptr 객체에 대한 참조인 경우(예: 기본적으로 구성된 QRectF 를 전달할 때) 경계 사각형은 크기로 제한되지 않습니다.

flags 인수는 다음 플래그의 비트 단위 OR입니다:

• Qt::AlignLeft 아랍어와 히브리어가 오른쪽에 정렬되는 경우를 제외하고 왼쪽 테두리에 정렬합니다.
• Qt::AlignRight 아랍어와 히브리어가 왼쪽에 정렬되는 경우를 제외하고 오른쪽 테두리에 정렬합니다.
• Qt::AlignJustify 맞춤 텍스트를 생성합니다.
• Qt::AlignHCenter 가로 중앙에 정렬합니다.
• Qt::AlignTop 위쪽 테두리에 맞춥니다.
• Qt::AlignBottom 아래쪽 테두리에 맞춥니다.
• Qt::AlignVCenter 세로 중앙에 정렬합니다.
• Qt::AlignCenter (== Qt::AlignHCenter | Qt::AlignVCenter)
• Qt::TextSingleLine 텍스트의 개행 문자를 무시합니다.
• Qt::TextExpandTabs 탭을 펼칩니다(아래 참조).
• Qt::TextShowMnemonic "&x"를 x, 즉 밑줄로 해석합니다.
• Qt::TextWordWrap 직사각형에 맞게 텍스트를 잘라냅니다.

Qt::Horizontal 가로 맞춤의 기본값은 Qt::AlignLeft 이고 세로 맞춤의 기본값은 Qt::AlignTop 입니다.

가로 맞춤 플래그 중 여러 개 또는 세로 맞춤 플래그 중 여러 개가 설정되어 있으면 결과 맞춤이 정의되지 않습니다.

이러한 플래그는 Qt::AlignmentFlag 에 정의되어 있습니다.

flags 에서 Qt::TextExpandTabs 이 설정된 경우 텍스트의 탭 문자를 해석하는 데 다음 동작이 사용됩니다:

• tabArray 가 0이 아닌 경우 텍스트의 탭에 대해 0으로 끝나는 픽셀 위치 시퀀스를 지정합니다.
• tabStops 이 0이 아닌 경우 탭 간격(픽셀 단위)으로 사용됩니다.

경계 사각형은 이탤릭체 글꼴의 경우 (0, 0)의 왼쪽으로 확장될 수 있습니다(예: 이탤릭체 글꼴).

개행 문자는 줄 바꿈으로 처리됩니다.

실제 문자 높이는 다르지만 "예"와 "예"의 경계 사각형의 높이는 동일합니다.

이 함수가 반환하는 경계 사각형은 더 간단한 boundingRect() 함수로 계산한 것보다 다소 큽니다. 이 함수는 여러 줄 텍스트가 올바르게 정렬되는 데 필요한 maximum left 및 right 글꼴 베어링을 사용합니다. 또한 fontHeight() 및 lineSpacing()는 개별 문자 높이가 아닌 높이를 계산하는 데 사용됩니다.

horizontalAdvance(), QPainter::boundingRect() 및 Qt::Alignment 를참조하세요 .

qreal QFontMetricsF::capHeight() const

글꼴의 대문자 높이를 반환합니다.

글꼴의 캡 높이는 기준선 위의 대문자 높이를 말합니다. 특히 오버행이 표시될 수 있는 O와 같은 둥근 문자나 A와 같은 뾰족한 문자와는 달리 H 또는 I와 같이 평평한 대문자의 높이를 나타냅니다.

ascent()도 참조하세요 .

qreal QFontMetricsF::descent() const

글꼴의 하강을 반환합니다.

하강은 기준선에서 문자가 확장되는 가장 낮은 지점까지의 거리입니다. (1픽셀을 더하는 X와는 다릅니다.) 실제로 일부 글꼴 디자이너는 특정 문자를 수용하기 위해 이 규칙을 어기는 경우가 있으므로 이 값이 너무 작을 수 있습니다(드물지만).

ascent()도 참조하세요 .

QString QFontMetricsF::elidedText(const QString &text, Qt::TextElideMode mode, qreal width, int flags = 0) const

문자열 text 이 width 보다 넓은 경우 문자열의 생략된 버전(즉, "..."이 포함된 문자열)을 반환합니다. 그렇지 않으면 원래 문자열을 반환합니다.

mode 매개 변수는 텍스트가 왼쪽(예: "...tech"), 가운데(예: "Tr...ch") 또는 오른쪽(예: "Trol...")에서 생략될지 여부를 지정합니다.

width 는 문자가 아닌 픽셀 단위로 지정됩니다.

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

줄 바꿈 표시는 layoutdirection 뒤에옵니다. 예를 들어 mode 이 Qt::ElideLeft 인 경우 오른쪽에서 왼쪽 레이아웃의 경우 텍스트의 오른쪽에, mode 이 Qt::ElideRight 인 경우 텍스트의 왼쪽에 표시됩니다.

qreal QFontMetricsF::fontDpi() const

글꼴 DPI를 반환합니다.

qreal QFontMetricsF::height() const

글꼴의 높이를 반환합니다.

이 값은 항상 ascent()+descent()와 같습니다.

leading() 및 lineSpacing()도 참조하세요 .

[since 6.3] qreal QFontMetricsF::horizontalAdvance(const QString &text, const QTextOption &option) const

option 을 사용하여 배치한 text 의 가로 전진을 픽셀 단위로 반환합니다.

이 전진은 text 뒤에 후속 문자를 그리기에 적합한 거리입니다.

이 함수는 Qt 6.3에 도입되었습니다.

boundingRect()도 참조하십시오 .

qreal QFontMetricsF::horizontalAdvance(const QString &text, int length = -1) const

text 의 첫 번째 length 문자의 가로 전진(픽셀)을 반환합니다. length 이 음수(기본값)이면 전체 문자열이 사용됩니다. length 이 훨씬 짧더라도 text 의 전체 길이가 분석됩니다.

전진은 text 뒤에 후속 문자를 그리는 데 적합한 거리입니다.

boundingRect()도 참조하세요 .

qreal QFontMetricsF::horizontalAdvance(QChar ch) const

이 함수는 오버로드된 함수입니다.

ch 문자의 수평 전진을 픽셀 단위로 반환합니다. 이는 ch 다음에 후속 문자를 그리기에 적합한 거리입니다.

일부 메트릭은 오른쪽 이미지에 설명되어 있습니다. 중앙의 짙은 직사각형은 각 문자의 논리적 수평 어드밴스()를 나타냅니다. 바깥쪽 옅은 직사각형은 각 문자의 leftBearing() 및 rightBearing()를 포함합니다. 이 특정 글꼴에서 "f"의 방위각은 모두 음수이고 "o"의 방위각은 모두 양수입니다.

boundingRect()도 참조하세요 .

bool QFontMetricsF::inFont(QChar ch) const

ch 문자가 글꼴의 유효한 문자인 경우 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

bool QFontMetricsF::inFontUcs4(uint ch) const

ch 으로 지정된 문자가 UCS-4/UTF-32로 인코딩된 글꼴의 유효한 문자인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

qreal QFontMetricsF::leading() const

글꼴의 앞부분을 반환합니다.

이것은 자연스러운 줄간 간격입니다.

height() 및 lineSpacing()도 참조하세요 .

qreal QFontMetricsF::leftBearing(QChar ch) const

글꼴에서 ch 문자의 왼쪽 방위각을 반환합니다.

왼쪽 방위각은 문자의 논리적 원점에서 문자의 가장 왼쪽 픽셀의 오른쪽 거리입니다. 문자의 픽셀이 논리적 원점의 왼쪽으로 확장되면 이 값은 음수입니다.

이 메트릭에 대한 그래픽 설명은 horizontalAdvance()를 참조하세요.

rightBearing(), minLeftBearing() 및 horizontalAdvance()도 참조하세요 .

qreal QFontMetricsF::lineSpacing() const

한 기준선으로부터 다음 기준선까지의 거리를 반환합니다.

이 값은 항상 leading()+height()와 같습니다.

height() 및 leading()도 참조하세요 .

qreal QFontMetricsF::lineWidth() const

글꼴의 포인트 크기에 맞게 조정된 밑줄 및 취소선의 너비를 반환합니다.

underlinePos(), overlinePos() 및 strikeOutPos()도 참조하세요 .

qreal QFontMetricsF::maxWidth() const

글꼴에서 가장 넓은 문자의 너비를 반환합니다.

qreal QFontMetricsF::minLeftBearing() const

글꼴의 최소 왼쪽 방위각을 반환합니다.

이 값은 글꼴의 모든 문자 중 가장 작은 leftBearing(문자)입니다.

글꼴이 큰 경우 이 함수는 매우 느릴 수 있습니다.

minRightBearing() 및 leftBearing()도 참조하세요 .

qreal QFontMetricsF::minRightBearing() const

글꼴의 최소 오른쪽 방위각을 반환합니다.

이 값은 글꼴의 모든 문자 중 가장 작은 rightBearing(문자)입니다.

글꼴이 큰 경우 이 함수는 매우 느릴 수 있습니다.

minLeftBearing() 및 rightBearing()도 참조하세요 .

qreal QFontMetricsF::overlinePos() const

기준선에서 오버라인을 그려야 하는 위치까지의 거리를 반환합니다.

underlinePos(), strikeOutPos() 및 lineWidth()도 참조하세요 .

qreal QFontMetricsF::rightBearing(QChar ch) const

글꼴에서 ch 문자의 오른쪽 방위각을 반환합니다.

오른쪽 방위각은 후속 문자의 논리적 원점으로부터 문자의 가장 오른쪽 픽셀의 왼쪽 거리입니다. 문자의 픽셀이 문자의 horizontalAdvance()의 오른쪽으로 확장되는 경우 이 값은 음수입니다.

이 메트릭에 대한 그래픽 설명은 horizontalAdvance()를 참조하세요.

leftBearing(), minRightBearing() 및 horizontalAdvance()도 참조하세요 .

QSizeF QFontMetricsF::size(int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

주어진 text 에 있는 문자의 크기를 픽셀 단위로 반환합니다.

flags 인수는 다음 플래그의 비트 단위 OR입니다:

• Qt::TextSingleLine 개행 문자를 무시합니다.
• Qt::TextExpandTabs 탭을 확장합니다(아래 참조).
• Qt::TextShowMnemonic "&x"를 x(즉, 밑줄)로 해석합니다.
• Qt::TextWordWrap 텍스트를 직사각형에 맞게 잘라냅니다.

이러한 플래그는 Qt::TextFlag 열거형에 정의되어 있습니다.

flags 에서 Qt::TextExpandTabs 이 설정된 경우 텍스트의 탭 문자를 해석하는 데 다음과 같은 동작이 사용됩니다:

• tabArray 이 0이 아닌 경우 텍스트의 탭에 대해 0으로 끝나는 픽셀 위치 시퀀스를 지정합니다.
• tabStops 이 0이 아닌 경우 탭 간격(픽셀 단위)으로 사용됩니다.

개행 문자는 줄 바꿈으로 처리됩니다.

참고: 실제 문자 높이는 다르지만 "예"와 "예"의 경계 사각형의 높이는 동일합니다.

boundingRect()도 참조하세요 .

qreal QFontMetricsF::strikeOutPos() const

기준선에서 삼진아웃선이 그려져야 하는 위치까지의 거리를 반환합니다.

underlinePos(), overlinePos() 및 lineWidth()도 참조하세요 .

[noexcept] void QFontMetricsF::swap(QFontMetricsF &other)

이 글꼴 메트릭 인스턴스를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

QRectF QFontMetricsF::tightBoundingRect(const QString &text) const

text 에 지정된 문자열의 문자를 둘러싸는 단단한 경계 사각형을 반환합니다. 경계 사각형은 항상 (0, 0)에 그릴 경우 텍스트가 포함할 픽셀 세트 이상을 포함합니다.

경계 사각형은 이탤릭체 글꼴의 경우 (0, 0)의 왼쪽으로 확장될 수 있으며, 반환된 사각형의 너비는 horizontalAdvance() 메서드가 반환하는 것과 다를 수 있다는 점에 유의하세요.

문자열의 앞쪽 너비를 알고 싶다면(문자열 세트를 나란히 배치하기 위해) horizontalAdvance()를 대신 사용하세요.

줄 바꿈 문자는 줄 바꿈이 아닌 일반 문자로 처리됩니다.

horizontalAdvance(), height() 및 boundingRect()도 참조하세요 .

[since 6.3] QRectF QFontMetricsF::tightBoundingRect(const QString &text, const QTextOption &option) const

option 을 사용하여 배치된 text 으로 지정된 문자열의 문자를 둘러싼 단단한 경계 사각형을 반환합니다. 경계 사각형은 항상 (0,0)에 그릴 경우 텍스트가 포함할 픽셀 세트 이상을 포함합니다.

경계 사각형은 이탤릭체 글꼴의 경우 (0, 0)의 왼쪽으로 확장될 수 있으며, 반환되는 사각형의 너비는 horizontalAdvance() 메서드가 반환하는 것과 다를 수 있다는 점에 유의하세요.

문자열의 앞쪽 너비를 알고 싶다면(문자열 세트를 나란히 배치하기 위해) horizontalAdvance()를 대신 사용하세요.

줄 바꿈 문자는 줄 바꿈이 아닌 일반 문자로 처리됩니다.

이 함수는 Qt 6.3에 도입되었습니다.

horizontalAdvance(), height() 및 boundingRect()도 참조하세요 .

qreal QFontMetricsF::underlinePos() const

기준선에서 밑줄을 그려야 하는 위치까지의 거리를 반환합니다.

overlinePos(), strikeOutPos() 및 lineWidth()도 참조하세요 .

qreal QFontMetricsF::xHeight() const

글꼴의 'x' 높이를 반환합니다. 이는 종종 문자 'x'의 높이와 같지만 항상 같은 것은 아닙니다.

bool QFontMetricsF::operator!=(const QFontMetricsF &other) const

이 함수는 오버로드된 함수입니다.

글꼴 메트릭이 other 글꼴 메트릭과 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

operator==()도 참조하세요 .

[noexcept] QFontMetricsF &QFontMetricsF::operator=(QFontMetricsF &&other)

이동-이 other 인스턴스를 QFontMetricsF 인스턴스에 할당합니다.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetrics &other)

other 이 객체에 할당합니다.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetricsF &fm)

글꼴 메트릭 fm 을 이 글꼴 메트릭 객체에 할당합니다.

bool QFontMetricsF::operator==(const QFontMetricsF &other) const

글꼴 메트릭이 other 글꼴 메트릭과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

두 글꼴 메트릭이 동일한 QFont 에서 작성된 경우 두 글꼴 메트릭은 동일한 것으로 간주되며 작성된 페인트 장치는 호환되는 것으로 간주됩니다.