Qt之QCheckBox

简述

QCheckBox继承自QAbstractButton，它提供了一个带文本标签的复选框。

QCheckBox（复选框）和QRadioButton（单选框）都是选项按钮。这是因为它们都可以在开（选中）或者关（未选中）之间切换。区别是对用户选择的限制：单选框定义了“多选一”的选择，而复选框提供的是“多选多”的选择。

尽管在技术上可以通过复选框来实现单选框的行为，反之亦然，但还是强烈建议使用众所周知的约定。

QButtonGroup可以用来在视觉上把许多复选框组织在一起。

只要复选框被选中或者清除，都会发射一个stateChanged()信号。如果想在复选框状态改变的时候触发一个行为，请连接这个信号，可以使用 isChecked()来查询复选框是否被选中。

除了常用的选中和未选中两个状态，QCheckBox还可选地提供了第三种状态（半选）来表明“没有变化”。当需要给用户一个选中或者未选中复选框的选择时，这是很有用的。如果需要第三种状态，可以通过setTristate()来使它生效，并使用checkState()来查询当前的切换状态。

使用

和QPushButton一样，复选框可以显示文本或者图标。文本可以通过构造函数或者setText()来设置，图标可以通过setIcon()来设置。

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

这个例子中，快捷键为Alt+ A，详情请参阅QShortcut文档。要显示一个实际的符号，使用“&&”。

重要的继承函数：text()、setText()、pixmap()、setPixmap()、accel()、setAccel()、isToggleButton()、setDown()、isDown()、isOn()、checkState()、 autoRepeat()、isExclusiveToggle()、group()、setAutoRepeat()、toggle()、pressed()、released()、clicked()、toggled()、checkState()、stateChanged()。请参考：Qt之QAbstractButton

公共函数

• Qt::CheckState checkState() const
  返回复选框的选中状态。如果不需要三态的支持，可以使用QAbstractButton::isChecked()，它返回一个布尔值。

• bool isTristate() const
  复选框是否为一个三态复选框。

  默认的是false，也就是说复选框只有两个状态。

• void setCheckState(Qt::CheckState state)
  设置复选框的选中状态。如果不需要三态的支持，可以使用QAbstractButton:setChecked()，它接受一个布尔值。

• void setTristate(bool y = true)
  设置复选框为一个三态复选框。

信号

• void stateChanged(int state)
  当复选框状态发生改变，这个信号就会被发射。即：用户选中或者取消选中。

示例

下面我们实现一个三态复选框，并监听状态变化的事件。

效果

源码

QCheckBox *pCheckBox = new QCheckBox(this);
m_pLabel = new QLabel(this);

m_pLabel->setText("Click CheckBox...");
pCheckBox->setText(QString::fromLocal8Bit("三态复选框"));
pCheckBox->setTristate();  // 启用三态模式
connect(pCheckBox, SIGNAL(stateChanged(int)), this, SLOT(onStateChanged(int)));

void MainWindow::onStateChanged(int state)
{
    if (state == Qt::Checked) // "选中"
    {
        m_pLabel->setText("Checked");
    }
    else if(state == Qt::PartiallyChecked) // "半选"
    {
        m_pLabel->setText("PartiallyChecked");
    }
    else // 未选中 - Qt::Unchecked
    {
        m_pLabel->setText("Unchecked");
    }
}

首先，我们使用setTristate()设置复选框为三态，然后连接stateChanged()信号和槽函数，当用户点击复选框时，状态发生改变就会调用槽函数。

继续分析，那么如果我们不是手动在界面上点击，如何执行槽函数呢？

这时，有些人就会说这很简单啊，看connect就清楚了，直接发射stateChanged()信号或直接调用槽函数：

emit pCheckBox->stateChanged(Qt::PartiallyChecked);
onStateChanged(Qt::PartiallyChecked);

这当然可以，因为谁都能看懂。这里我想说的是除了这种方式外，还有木有其它方式呢？我们追朔到QCheckBox的基类QAbstractButton，它里面有一系列的信号和函数，我们可以尝试一下。

经过试验，我们归结了两类，分别是可触发和不可触发槽函数的：

• 不可触发槽函数：

emit pCheckBox->clicked(true);
emit pCheckBox->toggled(true);
emit pCheckBox->pressed();
emit pCheckBox->released();

• 可触发槽函数：

pCheckBox->animateClick();
pCheckBox->click();
pCheckBox->toggle();
pCheckBox->setChecked(true);
pCheckBox->setCheckState(Qt::PartiallyChecked); // QCheckBox自身接口

也就是说，通过调用这些信号或函数，我们可以很容易判定其是否可以触发stateChanged()信号，从而调用槽函数onStateChanged()。