이 페이지에서

QFontInfo Class

QFontInfo 클래스는 글꼴에 대한 일반적인 정보를 제공합니다. 더 보기...

헤더: #include <QFontInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

참고: 이 클래스의 모든 함수는 재진입 가능합니다.

공개 함수

QFontInfo(const QFont &font)
QFontInfo(const QFontInfo &fi)
QFontInfo(QFontInfo &&)
~QFontInfo()
bool bold() const
bool exactMatch() const
QString family() const
bool fixedPitch() const
bool italic() const
int pixelSize() const
int pointSize() const
qreal pointSizeF() const
QFont::Style style() const
QFont::StyleHint styleHint() const
QString styleName() const
void swap(QFontInfo &other)
(since 6.9) QList<QFontVariableAxis> variableAxes() const
int weight() const
QFontInfo &operator=(const QFontInfo &fi)

상세 설명

QFontInfo 클래스는 QFont 와 동일한 액세스 함수를 제공합니다(예: family(), pointSize(), italic(), weight(), fixedPitch(), styleHint() 등). 그러나 QFont 액세스 함수는 설정된 값을 반환하는 반면, QFontInfo 객체는 텍스트를 그리는 데 실제로 사용될 글꼴에 적용되는 값을 반환합니다.

예를 들어, 확장 불가능한 24pt Courier 글꼴이 설치된 컴퓨터에서 프로그램이 25pt Courier 글꼴을 요청할 경우, ` QFont `는 (일반적으로) 렌더링에 24pt Courier를 사용합니다. 이 경우, ` QFont::pointSize()`는 25를 반환하고, ` QFontInfo::pointSize()`는 24를 반환합니다.

QFontInfo 객체를 생성하는 방법에는 세 가지가 있습니다.

  1. QFont 를 사용하여 QFontInfo 생성자를 호출하면 화면 호환 글꼴에 대한 글꼴 정보 객체가 생성됩니다. 즉, 해당 글꼴은 프린터 글꼴일 수 없습니다. 나중에 글꼴이 변경되더라도 글꼴 정보 객체는 업데이트되지 않습니다.

    (참고: 프린터 글꼴을 사용하는 경우 반환되는 값이 부정확할 수 있습니다. 프린터 글꼴에 항상 접근할 수 있는 것은 아니므로, 프린터 글꼴이 제공되면 가장 유사한 화면 글꼴이 사용됩니다.)

  2. QWidget::fontInfo()는 위젯의 글꼴에 대한 글꼴 정보를 반환합니다. 이는 QFontInfo(widget->font())를 호출하는 것과 동일합니다. 나중에 위젯의 글꼴이 변경되더라도 글꼴 정보 객체는 업데이트되지 않습니다.
  3. QPainter::fontInfo()는 페인터의 현재 글꼴에 대한 글꼴 정보를 반환합니다. 나중에 페인터의 글꼴이 변경되더라도 글꼴 정보 객체는 업데이트되지 않습니다.

글꼴 존재 여부 확인

때로는 글꼴을 사용하기 전에 해당 글꼴이 존재하는지 확인하는 것이 유용할 수 있습니다. 이를 확인하는 가장 철저한 방법은 ` exactMatch()`를 사용하는 것입니다:

const QFont segoeFont(QLatin1String("Segoe UI"));
if (QFontInfo(segoeFont).exactMatch()) {
    // Use the font...
}

그러나 일부 플랫폼에서는 글꼴 패밀리에 대한 이러한 심층 검색이 성능에 부담을 줄 수 있습니다. ` QFontDatabase::families().contains() `는 더 빠르지만 덜 철저한 대안입니다:

const QLatin1String segoeUiFamilyName("Segoe UI");
if (QFontDatabase::families().contains(segoeUiFamilyName)) {
    const QFont segoeFont(segoeUiFamilyName);
    // Use the font...
}

이 방법이 덜 철저한 이유는 완전한 검색이 아니기 때문입니다. 일부 폰트 패밀리 별칭이 목록에서 누락될 수 있습니다. 하지만 이 접근 방식은 애플리케이션 시작 시간을 단축시키므로, 가능하다면 항상 이 방법을 우선적으로 사용해야 합니다.

QFont, QFontMetrics, QFontDatabase도 참조하십시오 .

멤버 함수 문서

QFontInfo::QFontInfo(const QFont &font)

font 에 대한 글꼴 정보 객체를 생성합니다.

이 글꼴은 화면 호환성이 있어야 합니다. 즉, widgets 또는 pixmaps 에서 텍스트를 그릴 때 사용하는 글꼴이어야 하며, QPicture 또는 QPrinter 에서 사용하는 글꼴은 아닙니다.

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

그리기 작업 시 폰트 정보를 가져오려면 QPainter::fontInfo()를 사용하십시오. 이렇게 하면 화면과 호환되지 않는 그리기 장치에서 그릴 때도 올바른 결과를 얻을 수 있습니다.

Checking for the existence of a font도 참조하십시오 .

QFontInfo::QFontInfo(const QFontInfo &fi)

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

[constexpr noexcept default] QFontInfo::QFontInfo(QFontInfo &&)

QFontInfo 의 인스턴스를 move-construct로 생성합니다.

[noexcept] QFontInfo::~QFontInfo()

글꼴 정보 객체를 삭제합니다.

bool QFontInfo::bold() const

weight()가 QFont::Normal 보다 큰 값을 반환할 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

weight() 및 QFont::bold()도 참조하십시오 .

bool QFontInfo::exactMatch() const

일치하는 윈도우 시스템 글꼴이 font로 지정된 글꼴과 정확히 동일한 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

QFont::exactMatch()도 참조하십시오 .

QString QFontInfo::family() const

일치하는 윈도우 시스템 글꼴의 가족 이름을 반환합니다.

QFont::family() 및 Checking for the existence of a font도 참조하십시오 .

bool QFontInfo::fixedPitch() const

일치하는 윈도우 시스템 글꼴의 고정 피치 값을 반환합니다.

QFont::fixedPitch()도 참조하십시오 .

bool QFontInfo::italic() const

일치하는 윈도우 시스템 글꼴의 이탤릭체 값을 반환합니다.

QFont::italic()도 참조하십시오 .

int QFontInfo::pixelSize() const

일치하는 윈도우 시스템 글꼴의 픽셀 크기를 반환합니다.

QFont::pointSize()도 참조하십시오 .

int QFontInfo::pointSize() const

일치하는 윈도우 시스템 글꼴의 포인트 크기를 반환합니다.

pointSizeF() 및 QFont::pointSize()도 참조하십시오 .

qreal QFontInfo::pointSizeF() const

일치하는 윈도우 시스템 글꼴의 포인트 크기를 반환합니다.

QFont::pointSizeF()도 참조하십시오 .

QFont::Style QFontInfo::style() const

일치하는 윈도우 시스템 글꼴의 스타일 값을 반환합니다.

QFont::style()도 참조하십시오 .

QFont::StyleHint QFontInfo::styleHint() const

일치하는 윈도우 시스템 글꼴의 스타일을 반환합니다.

현재는 QFont 에서 설정된 스타일 힌트만 반환합니다.

QFont::styleHint() 및 QFont::StyleHint도 참조하십시오 .

QString QFontInfo::styleName() const

이를 지원하는 시스템에서 일치하는 윈도우 시스템 글꼴의 스타일 이름을 반환합니다.

QFont::styleName()도 참조하십시오 .

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

이 글꼴 정보 인스턴스를 other 로 교체합니다. 이 작업은 매우 빠르며 실패하는 일이 없습니다.

[since 6.9] QList<QFontVariableAxis> QFontInfo::variableAxes() const

글꼴이 가변 글꼴인 경우, 이 함수는 해당 글꼴이 지원하는 축의 목록을 반환합니다.

가변 축에 대한 자세한 내용은 setVariableAxis()을 참조하십시오.

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

int QFontInfo::weight() const

일치하는 윈도우 시스템 글꼴의 가중치를 반환합니다.

QFont::weight() 및 bold()도 참조하십시오 .

QFontInfo &QFontInfo::operator=(const QFontInfo &fi)

fi 에 있는 글꼴 정보를 할당합니다.

© 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.