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()も参照 。