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默认字体。

对话框将根据给定的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()。