[QT入门]按钮类控件

一、概述

在Qt中，按钮类控件是用户界面中不可或缺的一部分，用于响应用户的点击操作。Qt提供了多种按钮类控件，如QPushButton、QRadioButton、QCheckBox等，它们都是QAbstractButton类的子类。本文将详细介绍这些按钮类控件的基本用法和高级特性。

二、QAbstractButton类

QAbstractButton是Qt中所有按钮类的基类，它提供了一些基本的按钮功能和属性。这个类是一个抽象类，不能直接实例化，而是通过继承它来创建具体的按钮类。通过继承QAbstractButton类，我们可以创建不同类型的按钮，如QPushButton、QCheckBox、QRadioButton等。这些具体的按钮类会继承并扩展QAbstractButton类的功能，以实现不同类型按钮的特定功能。

三、QPushButton

1. 简介

QPushButton是Qt中的一个常用按钮控件，用于在界面中添加按钮。它继承自QAbstractButton类，并提供了一系列的信号和槽函数，以便能够方便地响应按钮的点击事件。

2. 常用属性及方法

• text: 按钮上显示的文本内容。
• icon: 按钮上显示的图标。
• clicked(): 按钮被点击时的信号。
• setText(const QString &text): 设置按钮的文本内容。
• setIcon(const QIcon &icon): 设置按钮的图标。
• setFixedSize(const QSize &size): 设置按钮的固定大小。

3. 使用示例

创建一个带有图标和快捷键的按钮：

#include <QPushButton>  
#include <QIcon>  
  
QPushButton *button = new QPushButton(this);  
button->setText("我的按钮");  
QIcon icon(":/path/to/icon.png");  
button->setIcon(icon);  
button->setIconSize(QSize(50, 50));  
button->setShortcut(QKeySequence("Ctrl+B")); // 设置快捷键

四、QRadioButton

1. 简介

QRadioButton是Qt中用于实现单选按钮的控件。它继承自QAbstractButton类，并且被设计为一组互斥的按钮，意味着在同一组中只能选择一个单选按钮。

2. 常用属性及方法

• text(): 用于获取单选按钮的文本标签。
• setText(const QString &text): 用于设置单选按钮的文本标签。
• isChecked(): 用于检查单选按钮是否被选中。
• setChecked(bool checked): 用于设置单选按钮是否被选中。
• setIcon(const QIcon &icon): 设置单选按钮的图标。
• setIconSize(const QSize &size): 设置单选按钮的图标大小。
• setAutoExclusive(bool exclusive): 设置单选按钮是否自动排除其他已选中的单选按钮。

3. 使用示例

创建一个单选按钮组，并实现性别选择：

#include <QRadioButton>  
#include <QButtonGroup>  
  
// 假设在UI设计中已经创建了radioButton_male和radioButton_female  
QButtonGroup *group = new QButtonGroup(this);  
group->addButton(radioButton_male, 0);  
group->addButton(radioButton_female, 1);  
radioButton_male->setChecked(true); // 设置默认选中项  
  
// 连接信号到槽  
connect(radioButton_male, &QRadioButton::clicked, this, &Widget::onGenderSelected);  
connect(radioButton_female, &QRadioButton::clicked, this, &Widget::onGenderSelected);  
  
// 槽函数  
void Widget::onGenderSelected() {  
    if (radioButton_male->isChecked()) {  
        // 性别为男  
    } else if (radioButton_female->isChecked()) {  
        // 性别为女  
    }  
}

五、QCheckBox

1. 简介

QCheckBox是Qt中用于实现复选框（Checkbox）的控件。与单选按钮（QRadioButton）不同，复选框允许用户选择多个选项。它们通常用于表示是否启用某个功能或选项的状态。

2. 常用属性及方法

• text(): 获取复选框的文本标签。
• setText(const QString &text): 设置复选框的文本标签。
• isChecked(): 检查复选框是否被选中。
• setChecked(bool checked): 设置复选框的选中状态。
• setTristate(bool y = true): 设置复选框是否支持三种状态（选中、未选中、部分选中）。注意，在大多数情况下，复选框只支持两种状态（选中或未选中），但某些特定场景下可能需要部分选中的状态。
• setPartiallyChecked(bool checked): 当setTristate(true)被调用后，可以使用此方法设置复选框为部分选中状态。
• stateChanged(int state): 当复选框的状态改变时发出的信号。状态可以是Qt::Unchecked（0），Qt::PartiallyChecked（1，如果启用了三态模式），或Qt::Checked（2）。

3. 使用示例

假设你正在开发一个设置对话框，其中包含一个复选框用于启用或禁用自动保存功能：

#include <QCheckBox>  
#include <QVBoxLayout>  
#include <QWidget>  
  
class SettingsWidget : public QWidget {  
    Q_OBJECT  
  
public:  
    SettingsWidget(QWidget *parent = nullptr) : QWidget(parent) {  
        // 创建复选框  
        QCheckBox *autoSaveCheckBox = new QCheckBox("启用自动保存", this);  
  
        // 设置默认状态  
        autoSaveCheckBox->setChecked(true); // 假设默认启用自动保存  
  
        // 布局设置  
        QVBoxLayout *layout = new QVBoxLayout(this);  
        layout->addWidget(autoSaveCheckBox);  
  
        // 连接信号到槽  
        connect(autoSaveCheckBox, &QCheckBox::stateChanged, this, &SettingsWidget::onAutoSaveChanged);  
    }  
  
private slots:  
    void onAutoSaveChanged(int state) {  
        if (state == Qt::Checked) {  
            // 自动保存已启用  
        } else {  
            // 自动保存已禁用  
        }  
    }  
};