QFontMetrics Class

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

멤버 함수 문서

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

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

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

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

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

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

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

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

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

QFontMetrics::QFontMetrics(const QFontMetrics &fm)

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

[noexcept] QFontMetrics::~QFontMetrics()

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

int QFontMetrics::ascent() const

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

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

descent()도 참조하세요 .

int QFontMetrics::averageCharWidth() const

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

QRect QFontMetrics::boundingRect(QChar ch) const

좌표계의 원점에 ch 문자를 그릴 경우 잉크로 덮인 직사각형을 반환합니다.

경계 사각형은 (0, 0)의 왼쪽으로 확장될 수 있으며(예: 이탤릭체 글꼴의 경우) 텍스트 출력은 경계 사각형의 모든 픽셀을 포함할 수 있다는 점에 유의하세요. 공백 문자의 경우 직사각형은 일반적으로 비어 있습니다.

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

horizontalAdvance()도 참조하세요 .

QRect QFontMetrics::boundingRect(const QString &text) const

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

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

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

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

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

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

[since 6.3] QRect QFontMetrics::boundingRect(const QString &text, const QTextOption &option) const

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

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

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

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

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

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

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

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

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

text 에 지정된 문자열에 있는 문자의 경계 사각형을 반환하며, 이는 텍스트가 (0, 0)에 그려질 경우 텍스트가 덮을 픽셀의 집합입니다. 그림, 따라서 경계 사각형은 rect 사각형으로 제한됩니다.

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::TextExpandTabs 가 flags 에 설정된 경우: tabArray 가 0이 아닌 경우 탭의 0으로 끝나는 픽셀 위치 시퀀스를 지정하고, 그렇지 않고 tabStops 가 0이 아닌 경우 탭 간격(픽셀 단위)으로 사용됩니다.

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

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

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

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

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

QRect QFontMetrics::boundingRect(int x, int y, int width, int height, int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

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

x 및 y 좌표, width, height 로 지정된 사각형 내에서 주어진 text 에 대한 경계 사각형을 반환합니다.

Qt::TextExpandTabs 가 flags 에 설정되어 있고 tabArray 가 null이 아닌 경우 탭의 픽셀 위치가 0으로 끝나는 시퀀스를 지정하고, 그렇지 않으면 tabStops 가 0이 아닌 경우 탭 간격(픽셀 단위)으로 사용됩니다.

int QFontMetrics::capHeight() const

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

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

ascent()도 참조하세요 .

int QFontMetrics::descent() const

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

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

ascent()도 참조하세요 .

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

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

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

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

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

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

qreal QFontMetrics::fontDpi() const

글꼴 DPI를 반환합니다.

int QFontMetrics::height() const

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

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

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

[since 6.3] int QFontMetrics::horizontalAdvance(const QString &text, const QTextOption &option) const

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

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

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

boundingRect()도 참조하십시오 .

int QFontMetrics::horizontalAdvance(const QString &text, int len = -1) const

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

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

boundingRect()도 참조하세요 .

int QFontMetrics::horizontalAdvance(QChar ch) const

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

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

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

boundingRect()도 참조하세요 .

bool QFontMetrics::inFont(QChar ch) const

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

bool QFontMetrics::inFontUcs4(uint ucs4) const

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

int QFontMetrics::leading() const

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

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

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

int QFontMetrics::leftBearing(QChar ch) const

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

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

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

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

int QFontMetrics::lineSpacing() const

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

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

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

int QFontMetrics::lineWidth() const

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

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

int QFontMetrics::maxWidth() const

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

int QFontMetrics::minLeftBearing() const

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

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

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

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

int QFontMetrics::minRightBearing() const

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

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

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

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

int QFontMetrics::overlinePos() const

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

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

int QFontMetrics::rightBearing(QChar ch) const

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

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

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

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

QSize QFontMetrics::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::TextExpandTabs 가 flags 에 설정된 경우: tabArray 가 0이 아닌 경우 탭의 0으로 끝나는 픽셀 위치 시퀀스를 지정하고, 그렇지 않고 tabStops 가 0이 아닌 경우 탭 간격(픽셀 단위)으로 사용됩니다.

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

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

boundingRect()도 참조하세요 .

int QFontMetrics::strikeOutPos() const

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

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

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

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

QRect QFontMetrics::tightBoundingRect(const QString &text) const

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

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

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

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

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

[since 6.3] QRect QFontMetrics::tightBoundingRect(const QString &text, const QTextOption &option) const

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

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

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

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

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

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

int QFontMetrics::underlinePos() const

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

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

int QFontMetrics::xHeight() const

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

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

other 이 이 객체와 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

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

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

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

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

글꼴 메트릭을 할당합니다 fm.

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

other 이 이 객체와 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

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