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::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，然后使用setTristate()开启三态模式。
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)));槽函数，判断当前复选框状态，其中包括：选中（Qt::Checked）、半选（Qt::PartiallyChecked）、未选中（Qt::Unchecked）。
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");}
}QSS
复选框样式。
QCheckBox{spacing: 5px;color: white;
}
QCheckBox::indicator {width: 17px;height: 17px;
}
QCheckBox::indicator:enabled:unchecked {image: url(:/Images/checkBox);
}
QCheckBox::indicator:enabled:unchecked:hover {image: url(:/Images/checkBoxHover);
}
QCheckBox::indicator:enabled:unchecked:pressed {image: url(:/Images/checkBoxPressed);
}
QCheckBox::indicator:enabled:checked {image: url(:/Images/checkBoxChecked);
}
QCheckBox::indicator:enabled:checked:hover {image: url(:/Images/checkBoxCheckedHover);
}
QCheckBox::indicator:enabled:checked:pressed {image: url(:/Images/checkBoxCheckedPressed);
}
QCheckBox::indicator:enabled:indeterminate {image: url(:/Images/checkBoxIndeterminate);
}
QCheckBox::indicator:enabled:indeterminate:hover {image: url(:/Images/checkBoxIndeterminateHover);
}
QCheckBox::indicator:enabled:indeterminate:pressed {image: url(:/Images/checkBoxIndeterminatePressed);
}连接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()。
开关效果
我们来实现一个iphone中常见的开关效果 - 多选。
效果
源码
构建复选框QCheckBox，然后将它们添加至按钮组QButtonGroup中。
QHBoxLayout *pLayout = new QHBoxLayout();
m_pButtonGroup = new QButtonGroup(this);// 设置不互斥
m_pButtonGroup->setExclusive(false);
for (int i = 0; i < 3; ++i)
{QCheckBox *pCheckBox = new QCheckBox(this);// 设置文本pCheckBox->setText(QString::fromLocal8Bit("切换%1").arg(i + 1));pLayout->addWidget(pCheckBox);m_pButtonGroup->addButton(pCheckBox);
}
pLayout->setSpacing(10);
pLayout->setContentsMargins(10, 10, 10, 10);setLayout(pLayout);// 连接信号槽
connect(m_pButtonGroup, SIGNAL(buttonClicked(QAbstractButton*)), this, SLOT(onButtonClicked(QAbstractButton*)));槽函数，用来判断当前点击的按钮，以及获取按钮组各个按钮的选中状态。
void MainWindow::onButtonClicked(QAbstractButton *button)
{// 当前点击的按钮qDebug() << QString("Clicked Button : %1").arg(button->text());// 遍历按钮，获取选中状态QList<QAbstractButton*> list = m_pButtonGroup->buttons();foreach (QAbstractButton *pCheckBox, list){QString strStatus = pCheckBox->isChecked() ? "Checked" : "Unchecked";qDebug() << QString("Button : %1 is %2").arg(pCheckBox->text()).arg(strStatus);}
}QSS
复选框样式
QCheckBox{spacing: 2px;color: white;
}
QCheckBox::indicator {width: 45px;height: 30px;
}
QCheckBox::indicator:unchecked {image: url(:/Images/switchOff);
}
QCheckBox::indicator:unchecked:hover {image: url(:/Images/switchOffHover);
}
QCheckBox::indicator:unchecked:pressed {image: url(:/Images/switchOffPressed);
}
QCheckBox::indicator:checked {image: url(:/Images/switchOn);
}
QCheckBox::indicator:checked:hover {image: url(:/Images/switchOnHover);
}
QCheckBox::indicator:checked:pressed {image: url(:/Images/switchOnPressed);
}上面，我们通过调用QButtonGroup的setExclusive(false)来设置按钮组中的复选框不互斥（可以多选）。
如上，我们使用了QButtonGroup，仅仅为了演示复选框实现单选功能（只需设置setExclusive(true)打开互斥即可）。即使这样，如之前所言 - 强烈建议使用众所周知的约定。所以，如果要实现单选功能，建议选择QRadioButton。
Qt之QCheckBox相关推荐
- Qt QSS QCheckBox和QRadioButton
导读 单选按钮(QRadioButton)和复选框(QCheckBox)是界面设计中的重要元素.单选按钮只允许用户在一组选项中选择一个,且当其中一个被选中的时候,按钮组中的其他单选按钮自动取消.复选框 ...
- QT的QCheckBox类的使用
详细说明 QCheckBox小部件提供一个带有文本标签的复选框. QCheckBox是一个选项按钮,可以打开(选中)或关闭(取消选中). 复选框通常用于表示应用程序中可以启用或禁用而不会影响其他功能的 ...
- Qt之QPushButton
简述 前面章节我们分享过Qt之QAbstractButton,讲解了QAbstractButton的基本用法,本节着重讲解QPushButton. 简述 常用状态 效果 源码 QSS 更多参考 关于Q ...
- Qt之QToolButton
简述 QToolButton类提供了用于命令或选项可以快速访问的按钮,通常可以用在QToolBar里面. 工具按钮和普通的命令按钮不同,通常不显示文本,而显示图标. 简述 详细描述 常用接口 更多参考 ...
- opic4:Qt入门之常用qt控件认知之Button系列
opic4:Qt入门之常用qt控件认知之Button系列 2013-06-27 18:21:54 标签:QAbstractButton QPushButton QRadioButton 原创作品,允许 ...
- Qt之自定义控件（开关按钮）
简述 接触过IOS系统的童鞋们应该对开关按钮很熟悉,在设置里面经常遇到,切换时候的滑动效果比较帅气. 通常说的开关按钮,有两个状态:on.off. 下面,我们利用自定义控件来实现一个开关按钮. 简述 ...
- （项目实战）基于QT嵌入式ARM数据采集卡上位机（二）——页面布局
(项目实战)基于QT嵌入式ARM数据采集卡上位机(二)--页面布局 上一篇文章<基于 QT 嵌入式ARM数据采集卡上位机(一)> 下一篇文章<(项目实战)基于QT嵌入式ARM数据采集 ...
- qt开发教程视频c++入门自学qt5.5课程linux gui程序实战案例opia
-//A25 QT教程/ ├──Qt 5开发教程 | ├──Qt初级教程 | | ├──第10课&基于Widget的GUI编程 – 其他控件 | | ├──第11课&基于Widget的 ...
- Qt Button控件的属性说明
按钮,常常被理解为触发一种动作请求或者命令,是与用户进行指令交互的操作.Qt中Button系列根据用途被划分为不同的定义,其实现框架为QAbstractButton提供按钮的通用性功能,此为抽象基类, ...
最新文章
- 主机电源全是黑线怎么短接_汽车胎压监测即将成为强制标准，听听老司机怎么说...
- 交互原型细节提升之路
- Python可视化：Seaborn（二）
- 参加Tech.Ed 2006北京行
- 在物理内存中观察CLR托管内存及GC行为
- 获得当月时间chuo_擅用GTD时间管理法，远离焦虑情绪，让你的工作、学习井然有序...
- 已解决谷歌浏览器打不开axure原型
- js数组按中文拼音排序_这才是选择排序正确的打开方式！
- 基于linux cli( 命令行) 的翻译工具推荐
- 【最新Unity3D—Particle System粒子系统】最新Unity2017.2018.2019.2020均适用且超详细
- 华为交换机S5720-EI堆叠
- 涂涂乐的详细实现之四--unity3d调用EmguCV实现图片识别
- Storage of multidimensional arrays based on arbitrary tiling
- 判断IE版本并给出提示升级浏览器
- 毕业三周年，又一个离别季
- 计算机的文档库在哪哪里,电脑的word文档在哪里
- 【转载】Serverless 系列 （1）: 云的诞生和基础设施外包
- JetBrains Rider想创建新工程一直显示Syncing Project Templates...
- 为整数线性规划(integer linear programming,ILP)
- 号外！2021考研政治肖1000大幅修订？你的肖1000Anki牌组笔记已出炉！