AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

Qt之QCheckBox

2016-07-07 2138
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 简述QCheckBox继承自QAbstractButton，它提供了一个带文本标签的复选框。QCheckBox（复选框）和QRadioButton（单选框）都是选项按钮。这是因为它们都可以在开（选中）或者关（未选中）之间切换。区别是对用户选择的限制：单选框定义了“多选一”的选择，而复选框提供的是“多选多”的选择。尽管在技术上可以通过复选框来实现单选框的行为，反之亦

简述

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。

更多参考

文章标签：
iOS开发
潘志闻
目录
相关文章
潘志闻
|
Linux 调度 数据安全/隐私保护
Qt之QFtp
简述 QFtp 类提供了一个 FTP 协议的客户端实现。 该类提供了一个到 FTP 的直接接口，允许对请求有更多的控制。但是，对于新的应用程序，建议使用 QNetworkAccessManager 和 QNetworkReply，因为这些类拥有一个更简单、还更强大的 API。 简述 QFtp 工作流程 基本使用 连接并登录 FTP 服务器 切换工作目录 列出目
潘志闻
7117 1
Liuqz2009
|
3月前
|
安全 C++
Qt moveToThread
Qt moveToThread
Liuqz2009
41 0
齐锦程
|
6月前
|
前端开发 编译器 开发工具
Qt
Qt
齐锦程
336 0
阿甘兄
26 QT - 事件过滤器
26 QT - 事件过滤器
阿甘兄
45 0
人才程序员
|
存储
Qt之QLCDNumber
Qt之QLCDNumber
人才程序员
371 0
人才程序员
Qt 之 QSystemTrayIcon
Qt 之 QSystemTrayIcon
人才程序员
345 0
游客fcvboot535try
|
网络协议 Java PHP
C++Qt分享
C++Qt分享
游客fcvboot535try
126 0
清雨小竹
QT
QT
清雨小竹
183 0
潘志闻
Qt之QImageReader
简述 QImageReader类为从文件或设备读取图像提供了一个独立的接口。 读取图像最常用的方法是通过构造QImage和QPixmap，或通过调用QImage::load()和QPixmap::load()。QImageReader是一个专业读取图像的类，可以有更多的控制，例如，可以通过调用setScaledSize()读取图像成特定的大小，通过调用setClipRec
潘志闻
2606 0
吞吞吐吐的
|
Windows
Qt中的qreal
吞吞吐吐的
1927 0