「QT」标准对话框类 之 QFontDialog 字体对话框

✨博客主页
何曾参静谧的博客
📌文章专栏
「QT」QT5程序设计
📚全部专栏
「Win」Windows程序设计	「IDE」集成开发环境	「UG/NX」BlockUI集合
「C/C++」C/C++程序设计	「DSA」数据结构与算法	「UG/NX」NX二次开发
「QT」QT5程序设计	「File」数据文件格式	「UG/NX」NX定制开发
「Py」Python程序设计	「Math」探秘数学世界	「PK」Parasolid函数说明

QFontDialog在Qt 5.15中的使用详解

一、引言

QFontDialog是Qt框架中一个用于字体选择和预览的对话框类。它允许用户从系统的字体库中选择字体，并调整字体的大小、样式等属性。QFontDialog为开发者提供了一个便捷的接口，使得在应用程序中集成字体选择功能变得简单且直观。通过QFontDialog，用户可以预览不同字体和大小的效果，从而选择最适合其需求的字体设置。

二、使用范围

QFontDialog广泛应用于需要用户自定义文本样式的场景。例如，在文本编辑器、富文本编辑器、图像编辑软件、标签打印软件等应用程序中，QFontDialog都扮演着重要角色。它使得用户能够根据自己的喜好或需求，选择最适合的字体、大小和样式，从而增强文本的可读性和美观性。

三、类的头文件

要使用QFontDialog类，需要在你的源文件中包含<QFontDialog>头文件。此外，还需要在项目的.pro文件中添加QT += widgets，以确保包含了必要的Qt模块。

四、类的注意事项

1. 字体预览：QFontDialog提供了字体预览功能，用户在选择字体时可以看到实时的效果。
2. 初始设置：可以通过设置QFontDialog的初始字体来引导用户的选择。
3. 事件处理：在显示QFontDialog之前，确保主事件循环已经启动，以便正确处理用户交互。
4. 父窗口：将QFontDialog的父窗口参数设置为当前活动窗口或主窗口，以确保对话框能够正确显示和关闭。
5. 样式表：可以通过Qt的样式表功能来定制QFontDialog的外观。

五、类的继承

QFontDialog类继承自QDialog类，而QDialog类又继承自QWidget类。QWidget是所有用户界面组件的基类，提供基本的窗口功能。QDialog用于创建对话框窗口，通常用于与用户进行交互。QFontDialog则进一步扩展了QDialog的功能，专门用于提供字体选择对话框。

六、类的构造介绍

QFontDialog的构造可以通过两种方式进行：直接构造法和静态函数法。

• 直接构造法：先构造一个QFontDialog对象，然后通过设置其属性（如初始字体、是否显示样式选项等）来配置对话框，最后调用exec方法来显示对话框，并使用selectedFont方法来获取用户选择的字体。
• 静态函数法：使用QFontDialog提供的静态函数getFont，可以快速弹出一个字体选择对话框，并返回用户选择的字体。

七、公有函数介绍

QFontDialog提供了多个公有函数，用于配置对话框的属性、获取用户的选择等。常用的公有函数包括：

字体设置相关

• void setCurrentFont(const QFont &font)
  设置对话框的初始显示字体。参数font指定了对话框打开时默认选中的字体。

对话框选项配置

• void setOption(QFontDialog::FontDialogOption option, bool on = true)
  设置单个对话框选项。参数option指定要设置的选项，on决定是启用(true)还是禁用(false)该选项。

• void setOptions(QFontDialog::FontDialogOptions options)
  批量设置多个对话框选项。参数options是多个选项的组合，使用位或(|)操作符连接多个选项。

• bool testOption(QFontDialog::FontDialogOption option) const
  测试某个选项是否被启用。参数option指定要测试的选项，返回true表示该选项已启用。

其他功能

• QFont selectedFont() const
  返回用户当前选择的字体（在直接构造法中使用）。如果用户尚未选择或取消了对话框，返回默认字体。

可用选项说明

QFontDialog::FontDialogOption枚举定义了以下可用选项：

• NoButtons - 不显示"确定"和"取消"按钮
• DontUseNativeDialog - 不使用系统原生对话框
• ScalableFonts - 只显示可缩放字体
• NonScalableFonts - 只显示不可缩放字体
• MonospacedFonts - 只显示等宽字体
• ProportionalFonts - 只显示比例字体

使用示例

// 设置初始字体
QFont initialFont("Arial", 12);
fontDialog.setCurrentFont(initialFont);

// 设置对话框选项 - 只显示等宽字体且不使用系统原生对话框
fontDialog.setOptions(QFontDialog::MonospacedFonts | QFontDialog::DontUseNativeDialog);

// 单独设置一个选项
fontDialog.setOption(QFontDialog::NoButtons, true);

// 检查选项是否设置
if(fontDialog.testOption(QFontDialog::MonospacedFonts)) {
    qDebug() << "只显示等宽字体";
}

八、static函数介绍

QFontDialog提供了一个静态函数getFont，用于快速弹出一个字体选择对话框，并返回用户选择的字体。该函数的原型如下：

QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr, const QFont &initial = QFont(), bool showStyleOptions = true, QFontDialog::FontDialogOptions options = QFontDialog::NoButtons)

• ok：指向布尔值的指针，用于指示用户是否点击了对话框的“确定”按钮。
• parent：父窗口指针，通常设置为当前活动窗口或主窗口。
• initial：初始字体，用于设置对话框的初始字体。
• showStyleOptions：是否显示样式选项（如粗体、斜体、下划线等）。
• options：对话框选项，用于配置对话框的额外行为。

九、运算符重载

QFontDialog类没有重载任何运算符，因此在使用时不需要考虑运算符重载的问题。

十、详细代码举例

以下是一个使用QFontDialog的详细代码示例，展示了如何使用直接构造法和静态函数法来选择字体。

#include <QApplication>
#include <QFontDialog>
#include <QLabel>
#include <QVBoxLayout>
#include <QWidget>
#include <QDebug>

class FontSelector : public QWidget {
    Q_OBJECT

public:
    FontSelector(QWidget *parent = nullptr) : QWidget(parent) {
        QVBoxLayout *layout = new QVBoxLayout(this);

        label = new QLabel("这是一个示例文本", this);
        layout->addWidget(label);

        QPushButton *changeFontButton = new QPushButton("更改字体", this);
        layout->addWidget(changeFontButton);

        connect(changeFontButton, &QPushButton::clicked, this, &FontSelector::changeFont);
    }

private slots:
    void changeFont() {
        // 使用直接构造法
        QFontDialog dialog(this);
        dialog.setCurrentFont(label->font());
        if (dialog.exec() == QDialog::Accepted) {
            QFont selectedFont = dialog.selectedFont();
            label->setFont(selectedFont);
        }

        // 使用静态函数法
        /*bool ok;
        QFont selectedFont = QFontDialog::getFont(&ok, this, label->font());
        if (ok) {
            label->setFont(selectedFont);
        }*/
    }

private:
    QLabel *label;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    FontSelector window;
    window.show();

    return app.exec();
}

在这个示例中，我们创建了一个FontSelector类，它包含一个QLabel用于显示文本和一个QPushButton用于触发字体更改操作。当用户点击按钮时，会弹出一个QFontDialog对话框，用户可以选择新的字体，然后该字体将应用于标签的文本。代码中同时展示了如何使用直接构造法和静态函数法来选择字体，但只启用了直接构造法的部分（静态函数法的部分被注释掉了）。你可以根据需要选择其中一种方法来使用。

---