【Qt笔记】QRadioButton控件详解

冷眼看人间恩怨

已于 2024-08-27 14:32:57 修改

阅读量1.7k

点赞数 45

分类专栏： Qt 文章标签： qt 笔记开发语言 QRadioButton

于 2024-08-26 11:21:08 首次发布

本文链接：https://blog.csdn.net/qq_52924376/article/details/141553412

版权

Qt 专栏收录该内容

29 篇文章 9 订阅

订阅专栏

一、引言

在Qt中，QRadioButton 是一个非常常用的控件，用于实现单选按钮的功能。它允许用户从一组选项中选择一个，并且这些选项之间通常是互斥的，即一次只能选中一个。

二、构造函数

2.1 未指定文本的构造函数

QRadioButton(QWidget *parent = nullptr): 创建一个没有文本和图标、且没有父部件的单选按钮。

// 创建一个没有文本、图标和父部件的单选按钮  
QRadioButton *radioNoTextNoIcon = new QRadioButton();

2.2 指定文本的构造函数

QRadioButton(const QString &text, QWidget *parent = nullptr): 使用指定的文本创建一个没有父部件的单选按钮。

// 使用指定的文本创建一个没有父部件的单选按钮  
QRadioButton *radioWithText = new QRadioButton("选项 1");

三、基本属性

3.1 文本和图标

文本和图标：QRadioButton 可以显示文本和/或图标，以便用户识别选项。

//创建一个窗口
QWidget window;  
window.setWindowTitle("QRadioButton 示例");  
  
//创建一个垂直布局
QVBoxLayout *layout = new QVBoxLayout(&window);  
  
// 创建并设置文本  
QRadioButton *radio1 = new QRadioButton("选项 1", &window);  
layout->addWidget(radio1);  
  
// 创建并设置图标和文本  
QIcon icon(":/path/to/icon.png"); // 注意替换为实际的图标路径  
QRadioButton *radio2 = new QRadioButton(&window);  
radio2->setText("选项 2");  
radio2->setIcon(icon);  
radio2->setIconSize(QSize(32, 32)); // 可选：设置图标大小  
layout->addWidget(radio2);  
  
//显示窗口
window.show();

3.2 选中状态

选中状态：每个 QRadioButton 都有一个选中状态，可以通过 setChecked(bool) 方法设置，并通过 isChecked() 方法查询。

// 假设radio1是之前创建的QRadioButton对象  
radio1->setChecked(true); // 设置radio1为选中状态  
bool isChecked = radio1->isChecked(); // 查询radio1的选中状态

3.3 自动互斥

自动互斥：默认情况下，如果多个 QRadioButton 属于同一个 QButtonGroup 或拥有相同的父部件（且 autoExclusive 属性为真），则它们将自动设置为互斥的。

#include <QButtonGroup>  
  
// ...  
  
QButtonGroup *group = new QButtonGroup(&window);  
group->addButton(radio1);  
group->addButton(radio2);  
// 由于使用了QButtonGroup，radio1和radio2自动互斥  
  
// 注意：autoExclusive属性不是QRadioButton的直接属性，  
// 它是由QButtonGroup管理的行为。

3.4 样式和外观

样式和外观：可以通过Qt样式表（QSS）或编程方式定制 QRadioButton 的外观，包括颜色、字体、边框等。

window.setStyleSheet("QRadioButton { color: blue; }"  
                     "QRadioButton:checked { background-color: lightgray; }"  
                     "QRadioButton:hover { color: red; }");

四、常用方法

4.1 设置文本

setText(const QString &text): 设置单选按钮的文本标签。

// 创建 QRadioButton 并设置文本  
QRadioButton *radio1 = new QRadioButton(&window);  
radio1->setText("选项 1");  
layout->addWidget(radio1);

4.2 设置图标

setIcon(const QIcon &icon): 设置单选按钮的图标。

// 创建 QRadioButton 并设置图标和图标大小  
QIcon icon(":/path/to/icon.png"); // 请替换为实际的图标路径  
QRadioButton *radio2 = new QRadioButton;  
radio2->setIcon(icon);

4.3 设置图标大小

setIconSize(const QSize &size): 设置单选按钮的图标大小。

radio2->setIconSize(QSize(32, 32)); // 设置图标大小

4.4 设置选中状态

setChecked(bool checked): 设置单选按钮是否被选中。如果为true，则按钮被选中；如果为false，则按钮未被选中。

// 设置单选按钮的选中状态  
radio1->setChecked(true); // 选中 radio1

4.5 检查选中状态

isChecked(): 返回单选按钮的选中状态。如果按钮被选中，则返回true；否则返回false。

// 检查单选按钮的选中状态  
if (radio1->isChecked()) {  
    qDebug() << "radio1 被选中";  
}

4.6 设置按钮是否可用

setEnabled(bool enabled): 设置单选按钮是否可用。如果为true，则按钮可用；如果为false，则按钮禁用。

// 设置单选按钮的可用性  
radio2->setEnabled(false); // 禁用 radio2

五、信号槽机制

QRadioButton提供了多种信号，允许开发者在按钮状态变化时执行特定的操作。最常用的信号包括clicked()、pressed()、released()和toggled(bool)。

clicked()：按钮被点击时发射。

pressed()：按钮被按下时发射。

released()：按钮被释放时发射。

toggled(bool)：按钮的选中状态改变时发射，参数表示当前是否选中。

可以通过connect()函数将信号与槽函数连接起来，以实现特定的功能。

connect(radioButton, &QRadioButton::toggled, this, &MyClass::onRadioButtonToggled);  
  
void MyClass::onRadioButtonToggled(bool checked) {  
    if (checked) {  
        // 按钮被选中时的处理  
    }  
}

六、整体代码示例

以下是一个包含多个 QRadioButton 的完整Qt窗口应用示例，展示了如何设置单选按钮、处理信号和槽，以及如何使用 QButtonGroup 来管理互斥选项。

#include <QApplication>  
#include <QWidget>  
#include <QVBoxLayout>  
#include <QRadioButton>  
#include <QButtonGroup>  
#include <QDebug>  
  
class RadioButtonDemo : public QWidget {  
    Q_OBJECT  
  
public:  
    RadioButtonDemo(QWidget *parent = nullptr) : QWidget(parent) {  
        // 初始化布局  
        QVBoxLayout *layout = new QVBoxLayout(this);  
  
        // 创建 QButtonGroup  
        QButtonGroup *buttonGroup = new QButtonGroup(this);  
  
        // 创建 QRadioButton 并添加到布局和组  
        QRadioButton *option1 = new QRadioButton("选项 1", this);  
        QRadioButton *option2 = new QRadioButton("选项 2", this);  
        QRadioButton *option3 = new QRadioButton("选项 3", this);  
  
        layout->addWidget(option1);  
        layout->addWidget(option2);  
        layout->addWidget(option3);  
  
        // 将单选按钮添加到 QButtonGroup  
        buttonGroup->addButton(option1);  
        buttonGroup->addButton(option2);  
        buttonGroup->addButton(option3);  
  
        // 设置默认选中的按钮  
        option1->setChecked(true);  
  
        // 连接信号  
        connect(buttonGroup, &QButtonGroup::buttonClicked, this, &RadioButtonDemo::onButtonClicked);  
    }  
  
private slots:  
    void onButtonClicked(QAbstractButton *button) {  
        // 当任何一个单选按钮被点击时，这个槽函数会被调用  
        qDebug() << "选中的按钮是：" << button->text();  
    }  
};  
  
#include "main.moc"  
  
int main(int argc, char *argv[]) {  
    QApplication app(argc, argv);  
  
    RadioButtonDemo demo;  
    demo.setWindowTitle("QRadioButton 示例");
  
    // 显示窗口  
    demo.show();  
  
    // 进入应用程序的主事件循环，等待事件（如鼠标点击、按键等）  
    return app.exec();  
}