QFontComboBox Class
QFontComboBox 위젯은 사용자가 글꼴 패밀리를 선택할 수 있는 콤보 박스입니다. 더 보기...
| Header: | #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)으로 채워집니다. 패밀리 이름은 가능한 경우 실제 글꼴을 사용하여 표시됩니다. 심볼과 같이 글꼴 자체에서 이름을 표현할 수 없는 글꼴의 경우 글꼴의 샘플이 패밀리 이름 옆에 표시됩니다.
QFontComboBox는 종종 도구 모음에서 글꼴 크기 제어를 위한 QComboBox 및 굵게 및 이탤릭체를 위한 QToolButton두 개와 함께 사용됩니다.
사용자가 새 글꼴을 선택하면 currentIndexChanged() 신호와 함께 currentFontChanged() 신호가 방출됩니다.
setWritingSystem()를 호출하여 지정된 쓰기 시스템을 지원하는 글꼴만 표시하도록 QFontComboBox에 지시하고, setFontFilters()를 호출하여 확장 불가능한 글꼴이나 단일 간격 글꼴과 같은 특정 유형의 글꼴을 필터링할 수 있습니다.
QComboBox, QFont, QFontInfo, QFontMetrics, QFontDatabase도 참조하세요 .
멤버 유형 문서
열거형 QFontComboBox::FontFilter
플래그 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
이 속성은 콤보박스에 대한 필터를 보유합니다.
기본적으로 모든 글꼴이 나열됩니다.
기능에 액세스합니다:
| 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 * 이벤트).
[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.
© 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.
