Roson讲Qt #8 QCheckBox(复选框)

古城微笑少年丶 2022-09-07 04:56 196阅读 0赞

# 1.什么是QCheckBox #

QCheckBox小部件提供了一个带有文本标签的复选框。  
      
    QCheckBox是一个选项按钮，可以打开(选中)或关闭(选中)。复选框通常用于表示应用程序中可以启用或禁用的特性，而不会影响其他人。可以实现不同类型的行为。例如，QButtonGroup可用于对复选按钮进行逻辑分组，允许独占复选框。但是，QButtonGroup不提供任何视觉表示。

下图进一步说明了独占复选框和非独占复选框之间的区别。

![20210822110819436.png][]

每当复选框被选中或清除时，它就会发出信号stateChanged()。如果您想在每次复选框改变状态时触发一个动作，请连接到此信号。可以使用isChecked()查询复选框是否被选中。

除了通常的已选中和未选中状态外，QCheckBox还可选择提供第三种状态来指示“无更改”。当您需要向用户提供既不勾选复选框也不取消勾选复选框的选项时，这是非常有用的。如果需要这第三种状态，可以使用setTrstate()启用它，并使用checkState()来查询当前的切换状态。

就像QPushButton一样，复选框显示文本和一个可选的小图标。图标是用setIcon()设置的。文本可以在构造函数中设置或使用setText()。快捷键可以在首选字符前面加上&号来指定。例如:

QCheckBox *checkbox = new QCheckBox("C&ase sensitive", this);

在本例中，快捷键是Alt+A。有关详细信息，请参阅QShortcut文档。要显示实际的&号，请使用'&&'。

# 2.QCheckBox使用 #

此控件用法比较简单，这里把整个代码文件都贴出来，请注意看代码中的注释。

**头文件**

#ifndef QAPP8211_H
    #define QAPP8211_H
    
    #include <QtWidgets/QMainWindow>
    #include "ui_qapp8211.h"
    
    class QApp8211 : public QMainWindow
    {
    	Q_OBJECT
    
    public:
    	QApp8211(QWidget *parent = 0);
    	~QApp8211();
    
    public slots:
    	void OnStateChanged(int state);
    
    private:
    	Ui::QApp8211Class ui;
    };
    
    #endif // QAPP8211_H

**cpp文件**

#include "qapp8211.h"
    #include "QDebug"
    
    QApp8211::QApp8211(QWidget *parent)
    	: QMainWindow(parent)
    {
    	ui.setupUi(this);
    
    	//设置文本
    	ui.checkBox->setText("My CheckBox");
    
    	//获取文本
    	ui.checkBox->text();
    
    	//判断是否被选中
    	if (ui.checkBox->isChecked())
    	{
    		qDebug()<<"is checked";
    	}
    
    	//设置为选中状态
    	ui.checkBox->setChecked(true);
    
    	//处理选中状态改变信号
    	connect(ui.checkBox,SIGNAL(stateChanged(int)),this,SLOT(OnStateChanged(int)));
    }
    
    QApp8211::~QApp8211()
    {
    
    }
    
    void QApp8211::OnStateChanged(int state)
    {
    	if (Qt::Checked == state)
    	{
    		qDebug()<<"checked";//选中
    	} 
    	else if (Qt::Unchecked == state)
    	{
    		qDebug()<<"No checked";//未选中
    	}
    }

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70][]

[20210822110819436.png]: /images/20220829/9ee76c99e8cc44aa93b90c33e0928199.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70]: /images/20220829/1bb34aafb77841f981c39f9ca598d9c4.png