【Qt笔记】QRadioButton控件详解

本文主要是介绍【Qt笔记】QRadioButton控件详解，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

一、引言

二、构造函数

2.1 未指定文本的构造函数

2.2 指定文本的构造函数

三、基本属性

3.1 文本和图标

3.2 选中状态

3.3 自动互斥

3.4 样式和外观

四、常用方法

4.1 设置文本

4.2 设置图标

4.3 设置图标大小

4.4 设置选中状态

4.5 检查选中状态

4.6 设置按钮是否可用

五、信号槽机制

六、整体代码示例

七、结语

一、引言

在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();  
}