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 参数不是空值，则在用户单击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 参数不是空值，则如果用户单击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()。