「QT」按钮类 之 QRadioButton 单选按钮类

✨博客主页
何曾参静谧的博客（✅关注、👍点赞、⭐收藏、👻转发）
📌文章专栏
「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函数说明
「Web」前后端全栈开发	「En」英语从零到一	👍占位符

QRadioButton在Qt 5.15中的详细介绍

一、引言

QRadioButton是Qt框架中用于创建单选按钮的类。它提供了一种直观的用户界面元素，允许用户在一组选项中选择一个。QRadioButton通常用于表单、设置对话框或任何需要用户从一组互斥选项中进行选择的场景。

二、使用范围

QRadioButton广泛应用于需要用户从一组选项中选择一个的场景，如性别选择、颜色选择、偏好设置等。它通常与其他QRadioButton一起使用，以确保用户只能选择一个选项。此外，QRadioButton还可以与QButtonGroup结合使用，以简化选项组的管理。

三、类的头文件

在Qt 5.15中，QRadioButton的头文件是<QRadioButton>。在使用QRadioButton之前，需要包含这个头文件。

#include <QRadioButton>

四、类的注意事项

1. 互斥性：QRadioButton是互斥的，即在一组QRadioButton中，用户只能选择一个。如果需要多个选项可以同时选择，请使用QCheckBox。
2. 分组：为了管理一组QRadioButton，可以使用QButtonGroup类。QButtonGroup提供了一种方便的方法来检查哪个按钮被选中，以及设置默认选中的按钮。
3. 状态变化：当用户点击QRadioButton时，它的状态会发生变化（选中或未选中）。可以通过连接QRadioButton的toggled信号来响应这种变化。
4. 样式与主题：QRadioButton的外观可以通过Qt样式表（QSS）进行定制，以符合应用程序的整体风格。

五、类的继承

QRadioButton继承自QAbstractButton类，后者又继承自QWidget类。QAbstractButton提供了按钮类共有的功能和属性，如检查状态、文本标签等。QWidget则是Qt中所有用户界面对象的基类。

六、类的构造介绍

QRadioButton的构造函数有多个重载版本，允许以不同的方式创建按钮。以下是一些常用的构造函数：

QRadioButton(QWidget *parent = nullptr);
QRadioButton(const QString &text, QWidget *parent = nullptr);
QRadioButton(const QIcon &icon, QWidget *parent = nullptr);
QRadioButton(const QIcon &icon, const QString &text, QWidget *parent = nullptr);

其中，parent参数指定了按钮的父部件（通常是一个对话框或窗口）。text和icon参数分别用于设置按钮的文本标签和图标。

七、公有函数介绍

QRadioButton提供了丰富的公有函数，用于设置和获取按钮的属性、状态和行为。以下是一些常用的公有函数：

1. isChecked和setChecked：检查按钮是否被选中，并设置按钮的选中状态。

   bool isChecked() const;
   void setChecked(bool checked);
   

2. setText和text：设置和获取按钮的文本标签。

   void setText(const QString &text);
   QString text() const;
   

3. setIcon和icon：设置和获取按钮的图标。

   void setIcon(const QIcon &icon);
   QIcon icon() const;
   

4. toggle：切换按钮的选中状态。

   void toggle();
   

八、Static函数介绍

QRadioButton没有提供静态函数。所有的按钮操作都是通过其实例方法实现的。

九、运算符重载

QRadioButton没有重载任何运算符。所有的按钮操作都是通过其公有函数实现的。

十、详细代码举例

以下是一个使用QRadioButton创建性别选择对话框的示例代码：

#include <QApplication>
#include <QDialog>
#include <QVBoxLayout>
#include <QRadioButton>
#include <QButtonGroup>
#include <QLabel>
#include <QMessageBox>

class GenderDialog : public QDialog {
    Q_OBJECT

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

        // 创建性别选择单选按钮
        QRadioButton *maleButton = new QRadioButton("Male", this);
        QRadioButton *femaleButton = new QRadioButton("Female", this);

        // 创建按钮组以管理单选按钮
        QButtonGroup *buttonGroup = new QButtonGroup(this);
        buttonGroup->addButton(maleButton);
        buttonGroup->addButton(femaleButton);

        // 连接按钮组的按钮点击信号到槽函数
        connect(buttonGroup, &QButtonGroup::buttonClicked, this, &GenderDialog::onButtonClicked);

        // 添加单选按钮到布局
        layout->addWidget(maleButton);
        layout->addWidget(femaleButton);

        // 添加一个标签来显示选中的性别
        genderLabel = new QLabel("No gender selected", this);
        layout->addWidget(genderLabel);

        // 设置对话框的布局
        setLayout(layout);

        // 设置对话框的窗口标题
        setWindowTitle("Gender Selection");
    }

private slots:
    // 处理按钮点击事件的槽函数
    void onButtonClicked(QAbstractButton *button) {
        QString selectedGender = button->text();
        genderLabel->setText("Selected gender: " + selectedGender);
    }

private:
    QLabel *genderLabel; // 用于显示选中的性别
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    GenderDialog dialog;
    dialog.exec();
    return app.exec();
}

#include "main.moc" // 如果使用qmake构建系统，则不需要此行；如果使用CMake等，请确保MOC被正确运行以生成必要的元对象代码

在这个示例中，我们创建了一个包含两个QRadioButton的对话框，用于选择性别。我们使用QButtonGroup来管理这两个按钮，以确保它们之间的互斥性。当用户点击其中一个按钮时，会触发onButtonClicked槽函数，更新标签以显示选中的性别。最后，我们设置了对话框的布局和窗口标题，并显示了对话框。

何曾参静谧的博客（✅关注、👍点赞、⭐收藏、👻转发）

---