跳转至

ComboBox 下拉选择

当选项过多时,使用下拉菜单展示并选择内容。样式参考 Element Plus / shadcn-ui。

基础用法

下拉选择预览

from monkeyqt import MkComboBox

combo = MkComboBox()
combo.addItem("选项一")
combo.addItem("选项一")
combo.addItem("选项三")

# 监听选择变化
combo.currentTextChanged.connect(lambda text: print(f"选中: {text}"))

设置默认选中

combo = MkComboBox()
combo.addItems(["苹果", "香蕉", "橘子", "西瓜"])
combo.setCurrentIndex(1)  # 默认选中"香蕉"

禁用状态 &

combo = MkComboBox()
combo.addItems(["选项A", "选项B"])
combo.setEnabled(False)

API

构造函数 &

MkComboBox(parent=None)

样式特性

状态 边框颜色 说明
默认 #e2e8f0 浅灰边框,圆角 6px
悬停 #cbd5e1 边框加深
聚焦/展开 #3b82f6 蓝色聚焦
禁用 #e2e8f0 灰色背景

继承

MkComboBox 继承自 QComboBox,支持 addItem()addItems()currentText()currentIndex()currentTextChanged 等所有原生方法和信号