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()も参照してください 。