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 が真の場合、与えられた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()も参照して ください。