QFontComboBox Class
QFontComboBox 위젯은 사용자가 글꼴 패밀리를 선택할 수 있게 해주는 콤보박스입니다. 더 보기...
| 헤더: | #include <QFontComboBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QComboBox |
공개 유형
| enum | FontFilter { AllFonts, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts } |
| flags | FontFilters |
속성
- currentFont : QFont
- fontFilters : FontFilters
- writingSystem : QFontDatabase::WritingSystem
공개 함수
| QFontComboBox(QWidget *parent = nullptr) | |
| virtual | ~QFontComboBox() |
| QFont | currentFont() const |
(since 6.3) std::optional<QFont> | displayFont(const QString &fontFamily) const |
| QFontComboBox::FontFilters | fontFilters() const |
(since 6.3) QString | sampleTextForFont(const QString &fontFamily) const |
(since 6.3) QString | sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const |
(since 6.3) void | setDisplayFont(const QString &fontFamily, const QFont &font) |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
(since 6.3) void | setSampleTextForFont(const QString &fontFamily, const QString &sampleText) |
(since 6.3) void | setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText) |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
| QFontDatabase::WritingSystem | writingSystem() const |
재구현된 공용 함수
| virtual QSize | sizeHint() const override |
공개 슬롯
| void | setCurrentFont(const QFont &f) |
신호
| void | currentFontChanged(const QFont &font) |
재구현된 보호 함수
| virtual bool | event(QEvent *e) override |
상세 설명
콤보박스에는 Arial, Helvetica, Times New Roman과 같은 글꼴 패밀리 이름이 알파벳 순으로 나열되어 있습니다. 가능한 경우, 패밀리 이름은 해당 글꼴을 사용하여 표시됩니다. Symbol과 같이 글꼴 자체로 이름을 표현할 수 없는 글꼴의 경우, 패밀리 이름 옆에 글꼴의 예시가 표시됩니다.
QFontComboBox는 툴바에서 글꼴 크기를 제어하는 QComboBox 와 굵은체 및 기울임체를 제어하는 두 개의 QToolButton와 함께 자주 사용됩니다.
사용자가 새 글꼴을 선택하면, currentIndexChanged() 신호 외에도 currentFontChanged() 신호가 발생합니다.
setWritingSystem()을 호출하여 QFontComboBox에 지정된 문자 체계를 지원하는 글꼴만 표시하도록 지시하고, setFontFilters()을 호출하여 비확장형 글꼴이나 고정폭 글꼴과 같은 특정 유형의 글꼴을 필터링할 수 있습니다.
QComboBox, QFont, QFontInfo, QFontMetrics 및 QFontDatabase도 참조하십시오 .
멤버 유형 문서
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
이 열거형을 사용하면 글꼴 콤보 상자에 특정 유형의 글꼴만 표시할 수 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QFontComboBox::AllFonts | 0 | 모든 글꼴 표시 |
QFontComboBox::ScalableFonts | 0x1 | 확장 가능한 글꼴 표시 |
QFontComboBox::NonScalableFonts | 0x2 | 확장 불가능한 글꼴 표시 |
QFontComboBox::MonospacedFonts | 0x4 | 고정폭 글꼴 표시 |
QFontComboBox::ProportionalFonts | 0x8 | 비례 글꼴 표시 |
FontFilters 유형은 QFlags<FontFilter>에 대한 typedef입니다. 이 유형은 FontFilter 값들의 OR 조합을 저장합니다.
속성 설명서
currentFont : QFont
이 속성은 현재 선택된 글꼴을 저장합니다
액세스 함수:
| QFont | currentFont() const |
| void | setCurrentFont(const QFont &f) |
알림 신호:
| void | currentFontChanged(const QFont &font) |
currentIndex 및 currentText도 참조하십시오 .
fontFilters : FontFilters
이 속성은 콤보박스의 필터 조건을 저장합니다.
기본적으로 모든 글꼴이 나열됩니다.
Access 함수:
| QFontComboBox::FontFilters | fontFilters() const |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
writingSystem도 참조하십시오 .
writingSystem : QFontDatabase::WritingSystem
이 속성은 콤보박스의 필터 역할을 하는 문자 체계를 지정합니다.
script 가 ' QFontDatabase::Any '(기본값)인 경우, 모든 글꼴이 나열됩니다.
액세스 함수:
| QFontDatabase::WritingSystem | writingSystem() const |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
fontFilters도 참조하십시오 .
멤버 함수 설명서
[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)
지정된 parent 를 사용하여 글꼴 콤보박스를 생성합니다.
[virtual noexcept] QFontComboBox::~QFontComboBox()
콤보박스를 제거합니다.
[signal] void QFontComboBox::currentFontChanged(const QFont &font)
이 신호는 현재 글꼴이 변경될 때마다, 새로운 ` font`와 함께 발생합니다.
참고: 속성 currentFont 에 대한알림 신호입니다.
currentFont도 참조하십시오 .
[since 6.3] std::optional<QFont> QFontComboBox::displayFont(const QString &fontFamily) const
지정된 fontFamily 를 표시하는 데 사용될 글꼴(설정된 경우)을 반환합니다(콤보 상자가 열려 있을 때).
이 함수는 Qt 6.3에서 도입되었습니다.
setDisplayFont()도 참조하십시오 .
[override virtual protected] bool QFontComboBox::event(QEvent *e)
QComboBox::event(QEvent *event)를 재구현합니다.
[since 6.3] QString QFontComboBox::sampleTextForFont(const QString &fontFamily) const
지정된 fontFamily 에 대해 콤보 상자가 열려 있을 때 글꼴 이름 뒤에 표시할 예시 텍스트를 반환합니다.
이 함수는 Qt 6.3에서 도입되었습니다.
setSampleTextForFont()도 참조하십시오 .
[since 6.3] QString QFontComboBox::sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const
지정된 writingSystem 에 대해, 콤보 상자가 열려 있을 때 글꼴 이름 뒤에 표시할 예시 텍스트를 반환합니다.
이 함수는 Qt 6.3에서 도입되었습니다.
setSampleTextForSystem()도 참조하십시오 .
[since 6.3] void QFontComboBox::setDisplayFont(const QString &fontFamily, const QFont &font)
지정된 fontFamily 을 표시하는 데 사용될 font 을 설정합니다(콤보 상자가 열려 있을 때).
이 함수는 Qt 6.3에서 도입되었습니다.
displayFont()도 참조하십시오 .
[since 6.3] void QFontComboBox::setSampleTextForFont(const QString &fontFamily, const QString &sampleText)
지정된 fontFamily 에 대해, 콤보 상자가 열려 있을 때 글꼴 이름 뒤에 표시될 sampleText 를 설정합니다.
이 함수와 함께 제공된 샘플 텍스트는 setSampleTextForSystem()로 설정된 텍스트보다 우선합니다.
이 함수는 Qt 6.3에서 도입되었습니다.
sampleTextForFont()도 참조하십시오 .
[since 6.3] void QFontComboBox::setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText)
지정된 writingSystem 에 대해, 콤보 상자가 열려 있을 때 글꼴 이름 뒤에 sampleText 가 표시되도록 설정합니다.
setSampleTextForFont() 함수와 함께 제공된 샘플 텍스트가 우선 적용됩니다.
이 함수는 Qt 6.3에서 도입되었습니다.
sampleTextForSystem()도 참조하십시오 .
[override virtual] QSize QFontComboBox::sizeHint() const
QComboBox::sizeHint() const를 재구현합니다.
© 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.
