QFontInfo Class
QFontInfo 클래스는 글꼴에 대한 일반적인 정보를 제공합니다. 더 보기...
헤더: | #include <QFontInfo> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- 사용되지 않는 멤버
- QFontInfo는 암시적으로 공유되는 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입됩니다.
공용 함수
QFontInfo(const QFont &font) | |
QFontInfo(const QFontInfo &fi) | |
~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) |
int | weight() const |
QFontInfo & | operator=(const QFontInfo &fi) |
상세 설명
QFontInfo 클래스는 family(), pointSize(), italic(), weight(), fixedPitch(), styleHint() 등과 같은 QFont 와 동일한 액세스 함수를 제공합니다. 그러나 QFont 액세스 함수는 설정된 값을 반환하는 반면, QFontInfo 객체는 실제로 텍스트를 그리는 데 사용되는 글꼴에 적용되는 값을 반환합니다.
예를 들어, 프로그램이 확장 불가능한 24pt Courier 글꼴이 있는 컴퓨터에서 25pt Courier 글꼴을 요청하면 QFont 은 (일반적으로) 24pt Courier를 렌더링에 사용합니다. 이 경우 QFont::pointSize()는 25를 반환하고 QFontInfo::pointSize()는 24를 반환합니다.
QFontInfo 객체를 만드는 방법은 세 가지가 있습니다.
- QFont 로 QFontInfo 생성자를 호출하면 화면 호환 글꼴에 대한 글꼴 정보 객체가 생성됩니다(즉, 글꼴은 프린터 글꼴일 수 없음). 나중에 글꼴이 변경되면 글꼴 정보 개체는 업데이트되지 않습니다.
(참고: 프린터 글꼴을 사용하는 경우 반환되는 값이 부정확할 수 있습니다. 프린터 글꼴을 항상 사용할 수 있는 것은 아니므로 프린터 글꼴이 제공된 경우 가장 가까운 화면 글꼴이 사용됩니다.)
- QWidget::fontInfo()는 위젯의 글꼴에 대한 글꼴 정보를 반환합니다. 이는 QFontInfo(widget->font())를 호출하는 것과 동일합니다. 나중에 위젯의 글꼴이 변경되면 글꼴 정보 객체는 업데이트되지 않습니다.
- 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 에 대한 폰트 정보 객체를 생성합니다.
글꼴은 화면 호환 가능해야 합니다. 즉, QPicture 또는 QPrinter 이 아닌 widgets 또는 pixmaps 에서 텍스트를 그릴 때 사용하는 글꼴이어야 합니다.
폰트 정보 객체는 생성 시 생성자에서 전달된 폰트에 대한 정보를 보유하며, 나중에 폰트의 속성이 변경되어도 업데이트되지 않습니다.
페인팅할 때 글꼴 정보를 가져오려면 QPainter::fontInfo()를 사용합니다. 이렇게 하면 화면과 호환되지 않는 페인트 장치에서 페인팅할 때도 올바른 결과를 얻을 수 있습니다.
Checking for the existence of a font 를참조하세요 .
QFontInfo::QFontInfo(const QFontInfo &fi)
fi 의 복사본을 생성합니다.
[noexcept]
QFontInfo::~QFontInfo()
글꼴 정보 개체를 삭제합니다.
bool QFontInfo::bold() const
weight()이 QFont::Normal 보다 큰 값을 반환하면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
weight() 및 QFont::bold()도 참조하세요 .
bool QFontInfo::exactMatch() const
일치하는 창 시스템 글꼴이 글꼴로 지정된 글꼴과 정확히 같으면 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 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.
int QFontInfo::weight() const
일치하는 창 시스템 글꼴의 가중치를 반환합니다.
QFont::weight() 및 bold()도 참조하세요 .
QFontInfo &QFontInfo::operator=(const QFontInfo &fi)
fi 에 글꼴 정보를 할당합니다.
© 2025 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.