当前位置：首页 > news >正文

qt QRadioButton详解

news 2025/7/3 23:09:25

QRadioButton 是一个可以切换选中（checked）或未选中（unchecked）状态的选项按钮。单选按钮通常呈现给用户一个“多选一”的选择，即在一组单选按钮中，一次只能选中一个按钮。

重要方法

QRadioButton(QWidget* parent = nullptr)：默认构造函数。
QRadioButton(const QString& text, QWidget* parent = nullptr)：使用指定的文本创建单选按钮。

void setText(const QString& text)：设置单选按钮显示的文本。
void setChecked(bool checked)：设置单选按钮的选中状态，true为选中，false为未选中。
bool isChecked() const：返回单选按钮的选中状态，如果选中则返回true，否则返回false。
void setIcon(const QIcon& icon)：设置单选按钮显示的图标。
void setShortcut(const QKeySequence& shortcut)：设置单选按钮的快捷键。

重要信号

toggled(bool checked)：当单选按钮切换选中状态时发射，参数为是否选中。
clicked(bool checked)：当单选按钮被点击时发射，参数为是否选中。

#include <QApplication>  
#include <QWidget>  
#include <QHBoxLayout>  
#include <QRadioButton>  
#include <QButtonGroup>  int main(int argc, char *argv[]) {  QApplication app(argc, argv);  // 创建主窗口  QWidget window;  window.setWindowTitle("RadioButton 示例");  // 创建水平布局  QHBoxLayout* layout = new QHBoxLayout(&window);  // 创建按钮组  QButtonGroup* buttonGroup = new QButtonGroup(&window);  // 创建三个单选按钮  QRadioButton* radioBtn1 = new QRadioButton("选项1");  QRadioButton* radioBtn2 = new QRadioButton("选项2");  QRadioButton* radioBtn3 = new QRadioButton("选项3");  // 默认设置第一个单选按钮选中  radioBtn1->setChecked(true);  // 将单选按钮添加到按钮组中  buttonGroup->addButton(radioBtn1);  buttonGroup->addButton(radioBtn2);  buttonGroup->addButton(radioBtn3);  // 将按钮组的 exclusive 属性设置为 true, 确保只能选中一个选项  buttonGroup->setExclusive(true);  // 将单选按钮添加到布局中  layout->addWidget(radioBtn1);  layout->addWidget(radioBtn2);  layout->addWidget(radioBtn3);  // 设置主窗口的布局  window.setLayout(layout);  // 显示主窗口  window.show();  return app.exec();  
}