基础输入

CheckBox 复选框

选择一个或多个选项；半选状态表示只选中了一部分。

示例

用法

响应勾选

连接 toggled 或 stateChanged，在勾选或取消时作出响应。

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* checkBox = new CheckBox("Accept terms", this);
auto* status = new Label("State: Unchecked", this);
connect(checkBox, &CheckBox::stateChanged, status, [status](int state) {
    status->setText(state == Qt::Checked ? "State: Checked" : "State: Unchecked");
});

auto* disabledOff = new CheckBox("Disabled off", this);
disabledOff->setEnabled(false);
auto* disabledOn = new CheckBox("Disabled on", this);
disabledOn->setChecked(true);
disabledOn->setEnabled(false);

import fluentqt

from PySide6.QtCore import Qt

check_box = fluentqt.CheckBox("Accept terms")
status = fluentqt.Label("State: Unchecked")
check_box.stateChanged.connect(
    lambda state: status.setText(
        "State: Checked"
        if Qt.CheckState(state) == Qt.CheckState.Checked
        else "State: Unchecked"
    )
)
disabled_off = fluentqt.CheckBox("Disabled off")
disabled_off.setEnabled(False)
disabled_on = fluentqt.CheckBox("Disabled on")
disabled_on.setChecked(True)
disabled_on.setEnabled(False)

半选状态

调用 setTristate(true) 后，可用 Qt::PartiallyChecked 表示只选中了一部分。

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* checkBox = new CheckBox("Enable selected items", this);
checkBox->setTristate(true);
checkBox->setCheckState(Qt::PartiallyChecked);
auto* status = new Label("State: Mixed", this);
connect(checkBox, &CheckBox::stateChanged, status, [status](int state) {
    status->setText(state == Qt::Checked ? "State: Checked"
            : state == Qt::PartiallyChecked
            ? "State: Mixed"
            : "State: Unchecked");
});

import fluentqt

from PySide6.QtCore import Qt

check_box = fluentqt.CheckBox("Enable selected items")
check_box.setTristate(True)
check_box.setCheckState(Qt.CheckState.PartiallyChecked)
status = fluentqt.Label("State: Mixed")
check_box.stateChanged.connect(
    lambda state: status.setText(
        "State: Checked"
        if Qt.CheckState(state) == Qt.CheckState.Checked
        else "State: Mixed"
        if Qt.CheckState(state) == Qt.CheckState.PartiallyChecked
        else "State: Unchecked"
    )
)

全选

主复选框随子选项显示全选、未选或半选。

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* selectAll = new CheckBox("Select all", this);
selectAll->setTristate(true);
auto* mail = new CheckBox("Mail", this);
auto* calendar = new CheckBox("Calendar", this);
auto* people = new CheckBox("People", this);

auto updateSelectAll = [=]() {
    const int checked = int(mail->isChecked()) + int(calendar->isChecked()) + int(people->isChecked());
    selectAll->setCheckState(checked == 0 ? Qt::Unchecked : checked == 3 ? Qt::Checked : Qt::PartiallyChecked);
};
connect(selectAll, &CheckBox::clicked, this, [=]() {
    const bool checked = selectAll->checkState() == Qt::Checked;
    mail->setChecked(checked);
    calendar->setChecked(checked);
    people->setChecked(checked);
});
connect(mail, &CheckBox::clicked, this, updateSelectAll);
connect(calendar, &CheckBox::clicked, this, updateSelectAll);
connect(people, &CheckBox::clicked, this, updateSelectAll);

import fluentqt

from PySide6.QtCore import Qt

select_all = fluentqt.CheckBox("Select all")
select_all.setTristate(True)
mail = fluentqt.CheckBox("Mail")
calendar = fluentqt.CheckBox("Calendar")
people = fluentqt.CheckBox("People")

def update_select_all():
    checked = sum(item.isChecked() for item in (mail, calendar, people))
    state = (
        Qt.CheckState.Unchecked if checked == 0
        else Qt.CheckState.Checked if checked == 3
        else Qt.CheckState.PartiallyChecked
    )
    select_all.setCheckState(state)

def apply_select_all():
    checked = select_all.checkState() == Qt.CheckState.Checked
    mail.setChecked(checked)
    calendar.setChecked(checked)
    people.setChecked(checked)

select_all.clicked.connect(apply_select_all)
mail.clicked.connect(update_select_all)
calendar.clicked.connect(update_select_all)
people.clicked.connect(update_select_all)

API

查看声明

`fluent::basicinput::CheckBox`

继承自 QCheckBox · FluentElement · QMLPlus

带选中态动画的 Fluent 复选框。

构造函数

explicit CheckBox(const QString& text = "", QWidget* parent = nullptr)
explicit CheckBox(QWidget* parent = nullptr)

属性

qreal checkProgress: 归一化的选中态动画进度。
读取 checkProgress()设置 setCheckProgress()
int boxSize: 复选框方框尺寸，单位为像素。
读取 boxSize()设置 setBoxSize()通知 boxSizeChanged()
int boxMargin: 复选框方框左侧前置间距。
读取 boxMargin()设置 setBoxMargin()通知 boxMarginChanged()
int textGap: 控件图形与文本内容之间的间距。
读取 textGap()设置 setTextGap()通知 textGapChanged()
bool hoverBackgroundEnabled: 悬停时是否绘制轻量背景。
读取 hoverBackgroundEnabled()设置 setHoverBackgroundEnabled()通知 hoverBackgroundEnabledChanged()