Qt入门系列开发教程基础控件篇复选按钮QCheckBox

Posted 2022-02-12 鱼酱2333

QCheckBox

QCheckBox 是一个选项按钮，可以打开（选中）或关闭（未选中）。 复选框通常用于表示应用程序中可以启用或禁用而不影响其他功能的功能。 可以实现不同类型的行为。 例如，QButtonGroup 可用于对复选按钮进行逻辑分组，允许独占复选框。 但是，QButtonGroup 不提供任何可视化表示。
下图进一步说明了独占复选框和非独占复选框之间的区别。

检查或清除复选框时，它会发出信号statechanged（）。 如果您想在每次复选框更改状态时触发操作，请连接到此信号。 您可以使用 isChecked() 来查询是否选中了复选框。
除了通常的选中和未选中状态之外，QCheckBox 还可以选择提供第三种状态来指示“没有变化”。 当您需要为用户提供既不选中也不取消选中复选框的选项时，这很有用。 如果您需要这第三种状态，请使用 setTristate() 启用它，并使用 checkState() 查询当前切换状态。
就像 QPushButton 一样，复选框显示文本，以及可选的小图标。 使用 setIcon() 设置图标。 文本可以在构造函数中设置，也可以使用 setText() 设置。 可以通过在首选字符前加上 & 符号来指定快捷键。 例如：

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

//选中状态
 Qt::CheckState checkState() const
 //此属性保存复选框是否为三态复选框
 bool isTristate() const
 //设置选中
 void setCheckState(Qt::CheckState state)
 //设置三选按钮
 void setTristate(bool y = true)

相关其它API

见QAbstractButton