跳转至

Checkbox 复选框

在一组选项中进行多选。对标 Element Plus 的 Checkbox,支持自定义尺寸和现代化的选中样式。

基础用法

复选框预览

from monkeyqt import MkCheckBox

# 基础复选框
cb = MkCheckBox("我已阅读并同意用户协议")

# 监听状态变化cb.stateChanged.connect(lambda state: print(f"选中状态: {state}"))

尺寸

cb_large   = MkCheckBox("大号复选框", size="large")
cb_default = MkCheckBox("默认复选框", size="default")
cb_small   = MkCheckBox("小号复选框", size="small")
尺寸 字号 高度 指示器大
cb__ "large" 14px 40px 16×16px
默认 "default" 14px 32px 14×14px
"small" 12px 24px 12×12px

禁用状态 &

cb = MkCheckBox("不可用选项")
cb.setEnabled(False)

# 禁用且选中
cb2 = MkCheckBox("已选定(不可修改)")
cb2.setChecked(True)
cb2.setEnabled(False)

API

构造函数 &

MkCheckBox(text="", parent=None, size="default")
参数 类型 默认值 说明
text str "" 复选框文本
parent QWidget None 父组件
size str "default" 尺寸:large / default / small

Properties

属性 类型 说明
mk_size str 读取/设置复选框尺寸

继承

MkCheckBox 继承自 QCheckBox,支持 stateChangedisChecked()setChecked() 等所有原生方法