QFontDialog Class

멤버 함수 문서

[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 *event)를 재구현합니다.

QFont QFontDialog::currentFont() const

현재 글꼴을 반환합니다.

setCurrentFont() 및 selectedFont()도 참조하십시오 .

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

이 신호는 현재 글꼴이 변경될 때 발생합니다. 새로운 글꼴은 ` font`에 지정됩니다.

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

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 글꼴이 반환됩니다.

이 대화 상자는 주어진 parent 및 options 에 지정된 옵션으로 생성됩니다. 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()));

이 예제에서 사용자가 'OK'를 클릭하면 선택한 글꼴이 적용되고, '취소'를 클릭하면 원래 글꼴이 사용됩니다.

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

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

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

대화 상자는 주어진 parent 를 사용하여 생성됩니다. ok 매개변수가 null이 아닌 경우, 사용자가 OK 를 클릭하면 이 매개변수가 가리키는 값이 true로 설정되고, Cancel 를 클릭하면 false로 설정됩니다.

예시:

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()` 신호를 ` receiver ` 및 ` member`로 지정된 슬롯에 연결합니다.

대화 상자가 닫히면 해당 신호는 슬롯에서 분리됩니다.

QFont QFontDialog::selectedFont() const

사용자가 ‘ OK ’ 또는 이에 상응하는 버튼을 클릭하여 선택한 글꼴을 반환합니다.

void QFontDialog::setCurrentFont(const QFont &font)

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

currentFont() 및 selectedFont()도 참조하십시오 .

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

on 가 true인 경우, 지정된 option 를 활성화하고, 그렇지 않은 경우 지정된 option 를 비활성화합니다.

options 및 testOption()도 참조하십시오 .

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

QDialog::setVisible(bool visible)을 재구현합니다.

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

지정된 option 가 활성화되어 있으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

options 및 setOption()도 참조하십시오 .