QFontDialog 类

成员函数文档

[显式] QFontDialog::QFontDialog(QWidget *parent = nullptr)

构建一个标准字体对话框。

使用setCurrentFont()来设置初始字体属性。

parent参数被传递到QDialog构造函数。

另请参阅 getFont()。

[显式] QFontDialog::QFontDialog(const QFont &initial, QWidget *parent = nullptr)

构建具有给定 父对象 和指定 初始 字体的标准字体对话框。

[重写虚拟保护] void QFontDialog::changeEvent(QEvent *e)

重写: QWidget::changeEvent(QEvent *event)。

QFont QFontDialog::currentFont() const

返回当前字体。

另请参阅 setCurrentFont() 和 selectedFont。

[信号] void QFontDialog::currentFontChanged(const QFont &font)

当前字体更换时发出此信号。新的字体以 font 指定。

在用户选择字体时发出信号。最终选定的字体可能与当前选定的字体不同。

另请参阅 currentFont、fontSelected 和 selectedFont。

[重写虚拟保护] void QFontDialog::done(int result)

重写: QDialog::done(int r)。

关闭对话框并设置其结果代码为 result。如果使用 exec() 显示此对话框，则 done() 会使局部事件循环结束，并使 exec() 返回 result。

另请参阅 QDialog::done。

[信号] void QFontDialog::fontSelected(const QFont &font)

选中字体时发出此信号。选中的字体以 font 指定。

仅当用户选择要使用的最终字体时才会发出此信号。在用户在字体对话框中更改当前字体时不会发出。

另请参阅 selectedFont、currentFontChanged 和 currentFont。

[静态] QFont QFontDialog::getFont(bool *ok, const QFont &initial, QWidget *parent = nullptr, const QString &title = QString(), QFontDialog::FontDialogOptions options = FontDialogOptions())

执行模态字体对话框并返回一个字体。

如果用户点击确定，将返回所选字体。如果用户点击取消，将返回初始字体。

该对话框使用指定的父和选项所述选项构建。 标题显示为对话框的窗口标题，而初始是默认选择的字体。如果ok参数非空，则在用户点击确定时，其所指值设为true，在用户点击取消时设为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()));

在此示例中，如果用户点击确定，将使用所选的字体；如果点击取消，则使用原始字体。

[静态] QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr)

这是一个重载函数。

执行模态字体对话框并返回一个字体。

如果用户点击确定，则返回所选字体。如果用户点击取消，则返回Qt默认字体。

使用给定的父构建对话框。如果ok参数非空，则在用户点击确定时，其所指值设为true，在用户点击取消时设为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

返回用户通过点击确定或等效按钮所选的字体。

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。

[覆盖虚函数] void QFontDialog::setVisible(bool visible)

重实现了：QDialog::setVisible(bool visible)。

bool QFontDialog::testOption(QFontDialog::FontDialogOption option) const

如果给定的 选项 被启用，则返回 true；否则，返回 false。

另请参阅 选项 和 setOption()。