QFontDialog Class

QFontDialog 클래스는 글꼴을 선택하기 위한 대화 상자 위젯을 제공합니다. 더 보기...

헤더: #include <QFontDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속합니다: QDialog

공용 유형

enum FontDialogOption { NoButtons, DontUseNativeDialog, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts }
flags FontDialogOptions

속성

공용 함수

QFontDialog(QWidget *parent = nullptr)
QFontDialog(const QFont &initial, QWidget *parent = nullptr)
QFont currentFont() const
void open(QObject *receiver, const char *member)
QFontDialog::FontDialogOptions options() const
QFont selectedFont() const
void setCurrentFont(const QFont &font)
void setOption(QFontDialog::FontDialogOption option, bool on = true)
void setOptions(QFontDialog::FontDialogOptions options)
bool testOption(QFontDialog::FontDialogOption option) const

재구현된 공용 함수

virtual void setVisible(bool visible) override

시그널

void currentFontChanged(const QFont &font)
void fontSelected(const QFont &font)

정적 공용 멤버

QFont getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())
QFont getFont(bool *ok, QWidget *parent = nullptr)

재구현된 보호 함수

virtual void changeEvent(QEvent *e) override
virtual void done(int result) override

상세 설명

글꼴 대화 상자는 정적 getFont() 함수 중 하나를 통해 생성됩니다.

예시:

bool ok;
QFont font = QFontDialog::getFont(
                &ok, QFont("Helvetica [Cronyx]", 10), this);
if (ok) {
    // the user clicked OK and font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Helvetica [Cronyx], 10
}

이 대화 상자를 사용하여 위젯의 글꼴을 직접 설정할 수도 있습니다:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

사용자가 확인을 클릭하면 선택한 글꼴이 내 위젯에 사용되며, 취소를 클릭하면 원래 글꼴이 사용됩니다.

A font dialog in the Fusion widget style.

QFont, QFontInfo, QFontMetrics, QColorDialog, QFileDialog표준 대화 상자 예시도참조하세요 .

멤버 유형 문서

열거형 QFontDialog::FontDialogOption
플래그 QFontDialog::FontDialogOptions

이 열거형은 폰트 대화 상자의 모양과 느낌에 영향을 주는 다양한 옵션을 지정합니다.

예를 들어 표시할 글꼴 유형을 지정할 수 있습니다. 아무것도 지정하지 않으면 사용 가능한 모든 글꼴이 나열됩니다.

일부 플랫폼(예: Mac)에서는 글꼴 필터링 옵션이 지원되지 않을 수 있습니다. 이 옵션은 항상 기본이 아닌 대화 상자(Windows 또는 Linux에서 사용)에서 지원됩니다.

상수설명
QFontDialog::NoButtons0x00000001OKCancel 버튼을 표시하지 않습니다. ("라이브 대화 상자"에 유용합니다.)
QFontDialog::DontUseNativeDialog0x00000002Mac에서 Apple의 기본 글꼴 패널 대신 Qt의 표준 글꼴 대화 상자를 사용합니다.
QFontDialog::ScalableFonts0x00000004확장 가능한 글꼴 표시
QFontDialog::NonScalableFonts0x00000008확장 불가능한 글꼴 표시
QFontDialog::MonospacedFonts0x00000010단일 간격 글꼴 표시
QFontDialog::ProportionalFonts0x00000020비례 글꼴 표시

FontDialogOptions 유형은 QFlags<FontDialogOption>에 대한 typedef입니다. 이 유형은 폰트다이얼로그옵션 값의 OR 조합을 저장합니다.

options, setOption() 및 testOption()도 참조하세요 .

속성 문서

currentFont : QFont

이 속성은 대화 상자의 현재 글꼴을 저장합니다.

함수에 액세스합니다:

QFont currentFont() const
void setCurrentFont(const QFont &font)

알림 신호:

void currentFontChanged(const QFont &font)

options : FontDialogOptions

이 속성에는 대화 상자의 모양과 느낌에 영향을 주는 다양한 옵션이 있습니다.

기본적으로 모든 옵션은 비활성화되어 있습니다.

대화 상자를 표시하기 전에 옵션을 설정해야 합니다. 대화 상자가 표시된 상태에서 옵션을 설정해도 옵션 및 플랫폼에 따라 대화 상자에 즉각적인 영향을 미치지는 않습니다.

기능에 액세스합니다:

QFontDialog::FontDialogOptions options() const
void setOptions(QFontDialog::FontDialogOptions options)

setOption() 및 testOption()도 참조하세요 .

멤버 함수 문서

[explicit] QFontDialog::QFontDialog(QWidget *parent = nullptr)

표준 글꼴 대화 상자를 생성합니다.

setCurrentFont()를 사용하여 초기 글꼴 속성을 설정합니다.

parent 매개 변수는 QDialog 생성자에 전달됩니다.

getFont()도 참조하세요 .

[explicit] QFontDialog::QFontDialog(const QFont &initial, QWidget *parent = nullptr)

주어진 parent 및 지정된 initial 글꼴을 사용하여 표준 글꼴 대화 상자를 작성합니다.

[override virtual protected] void QFontDialog::changeEvent(QEvent *e)

다시 구현합니다: QWidget::changeEvent(QEvent * 이벤트).

QFont QFontDialog::currentFont() const

현재 글꼴을 반환합니다.

참고: currentFont 속성에 대한 게터 함수입니다.

setCurrentFont() 및 selectedFont()도 참조하세요 .

[signal] void QFontDialog::currentFontChanged(const QFont &font)

이 신호는 현재 글꼴이 변경될 때 발생합니다. 새 글꼴은 font 에 지정되어 있습니다.

이 신호는 사용자가 글꼴을 선택하는 동안 발생합니다. 궁극적으로 선택한 글꼴은 현재 선택된 글꼴과 다를 수 있습니다.

참고: 속성에 대한 알림 신호 currentFont.

currentFont, fontSelected() 및 selectedFont()도 참조하세요 .

[override virtual protected] void QFontDialog::done(int result)

재구현합니다: QDialog::done(int r).

대화 상자를 닫고 결과 코드를 result 로 설정합니다. 이 대화 상자가 exec()와 함께 표시되면 done()는 로컬 이벤트 루프를 종료하고 exec()는 result 을 반환합니다.

QDialog::done()도 참조하세요 .

[signal] void QFontDialog::fontSelected(const QFont &font)

이 신호는 글꼴이 선택되었을 때 방출됩니다. 선택한 글꼴은 font 에 지정되어 있습니다.

이 신호는 사용자가 사용할 최종 글꼴을 선택한 경우에만 발생합니다. 사용자가 글꼴 대화 상자에서 현재 글꼴을 변경하는 동안에는 이 신호가 발생하지 않습니다.

selectedFont(), currentFontChanged() 및 currentFont참조하세요 .

[static] QFont QFontDialog::getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())

모달 글꼴 대화 상자를 실행하고 글꼴을 반환합니다.

사용자가 OK 을 클릭하면 선택한 글꼴이 반환됩니다. 사용자가 Cancel 을 클릭하면 initial 글꼴이 반환됩니다.

대화 상자는 지정된 parentoptions 에 지정된 옵션으로 구성됩니다. title 은 대화 상자의 창 제목으로 표시되고 initial 은 처음에 선택한 글꼴입니다. ok 매개 변수가 null이 아닌 경우, 사용자가 OK 을 클릭하면 참조하는 값이 true 로 설정되고 Cancel 을 클릭하면 false 로 설정됩니다.

예시:

bool ok;
QFont font = QFontDialog::getFont(&ok, QFont("Times", 12), this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Times, 12.
}

이 대화 상자를 사용하여 위젯의 글꼴을 직접 설정할 수도 있습니다:

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

이 예에서는 사용자가 확인을 클릭하면 선택한 글꼴이 사용되며, 취소를 클릭하면 원래 글꼴이 사용됩니다.

[static] QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr)

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

모달 글꼴 대화 상자를 실행하고 글꼴을 반환합니다.

사용자가 OK 을 클릭하면 선택한 글꼴이 반환됩니다. 사용자가 Cancel 을 클릭하면 Qt XML 기본 글꼴이 반환됩니다.

대화 상자는 주어진 parent 으로 구성됩니다. ok 매개변수가 null이 아닌 경우, 사용자가 OK 을 클릭하면 참조하는 값은 참으로 설정되고 Cancel 을 클릭하면 거짓으로 설정됩니다.

예시:

bool ok;
QFont font = QFontDialog::getFont(&ok, this);
if (ok) {
    // font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the default
    // application font, QApplication::font()
}

void QFontDialog::open(QObject *receiver, const char *member)

대화 상자를 열고 fontSelected() 신호를 receivermember 에 지정된 슬롯에 연결합니다.

대화 상자가 닫히면 신호가 슬롯에서 연결이 끊어집니다.

QFont QFontDialog::selectedFont() const

사용자가 OK 또는 이와 동등한 버튼을 클릭하여 선택한 글꼴을 반환합니다.

참고: 사용자가 최종적으로 사용할 글꼴을 선택하기 전에 다른 글꼴을 선택할 수 있으므로 이 글꼴은 currentFont 속성이 보유한 글꼴과 항상 동일하지는 않습니다.

void QFontDialog::setCurrentFont(const QFont &font)

QFontDialog 에서 강조 표시된 글꼴을 지정된 font 으로 설정합니다.

참고: currentFont 속성에 대한 세터 함수입니다.

currentFont() 및 selectedFont()도 참조하세요 .

void QFontDialog::setOption(QFontDialog::FontDialogOption option, bool on = true)

on 이 참이면 지정된 option 을 활성화하도록 설정하고, 그렇지 않으면 지정된 option 을 지웁니다.

optionstestOption()도 참조하세요 .

[override virtual] void QFontDialog::setVisible(bool visible)

다시 구현합니다: QDialog::setVisible(bool 표시).

bool QFontDialog::testOption(QFontDialog::FontDialogOption option) const

지정된 option 이 활성화된 경우 true 을 반환하고, 그렇지 않으면 false 를 반환합니다.

optionssetOption()도 참조하세요 .

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