平时写 Qt Widgets，我们对QComboBox的印象基本就是：
点一下 → 下拉 → 选个值 → 触发currentIndexChanged()→ 做点事。
但如果你做过参数面板、工具软件、工业 HMI、编辑器设置页，你会发现：
下拉框其实还能：
- 区分用户选择vs程序改值
- 变成可编辑输入框，还能按策略自动插入
- 支持placeholder 提示文本
- 接QCompleter 自动补全（甚至包含匹配）
- 绑定Model/View 模型
- 每项能存ID（UserRole），UI 和业务值分离
- 下拉里做分组分隔线
- 自定义弹出 View（性能/行为/样式都能控）
- 每项带图标（状态/级别选择神器）
- 可编辑时加 Validator（输入源头就限制）
- 输入就弹出候选（体验像搜索下拉）
- 禁用滚轮误触（参数面板必备）
这篇带你把这些能力一次玩明白。
跑起来后，你操作每个 Demo，顶部“状态区”会实时告诉你触发了啥。
文末附下载链接
01｜别乱连信号：activated/currentIndexChanged/currentTextChanged
你有没有遇到过这种情况：
- 你只想统计“用户真的选了某一项”
- 结果程序里
setCurrentIndex()也触发了信号，日志刷屏、业务误触发
关键点是：activated只在“用户操作选择”时触发；程序 set 不会触发它。
connect(cb,QOverload<int>::of(&QComboBox::activated),this,[=](intidx){m_status->setText(QString("activated index=%1 text=\"%2\"").arg(idx).arg(cb->itemText(idx)));});connect(cb,QOverload<int>::of(&QComboBox::currentIndexChanged),this,[=](intidx){m_status->setText(QString("currentIndexChanged index=%1").arg(idx));});✅典型用途：
埋点统计、用户确认动作、只响应“人为选择”的业务逻辑。
02｜把 ComboBox 当“输入+选择”：setEditable(true)+InsertPolicy
做“历史输入/最近使用/可扩展枚举”时，你往往不想自己维护一堆列表。
QComboBox可编辑后，用户输入新文本按 Enter，还能按策略自动插入到列表：
cb->setEditable(true);cb->addItems({"cat","dog","bird"});cb->setInsertPolicy(QComboBox::InsertAtTop);✅典型用途：
标签输入、路径/型号/备注历史、最近使用的配置项。
03｜Placeholder：让“未选择”更清晰
很多配置页里，下拉框空着时用户会懵：到底要选啥？
Qt 5.15+/Qt6 可以直接：
cb->setPlaceholderText("请选择国家（placeholderText）");这类细节做了，界面“高级感”会明显提升。
04｜自动补全：QCompleter（还支持包含匹配MatchContains）
默认补全经常只匹配前缀，体验偏“笨”。
你这份 Demo 直接上了包含匹配：
输入ber也能出blueberry / blackberry——很爽。
auto*c=newQCompleter(cb->model(),cb);c->setCaseSensitivity(Qt::CaseInsensitive);c->setFilterMode(Qt::MatchContains);cb->setCompleter(c);✅典型用途：
城市/物料/设备/枚举很长的下拉选择。
05｜QComboBox 本质是 Model/View：setModel(QStringListModel)
别再把 ComboBox 当“只能 addItems 的控件”了。
它本质就是 Model/View 的 View。
auto*model=newQStringListModel(w);model->setStringList({"alpha","beta","gamma","delta"});cb->setModel(model);✅典型用途：
接数据库、接设备列表、接动态枚举、甚至接更复杂的自定义模型。
06｜每项都能带“隐藏数据”：itemData(UserRole)存 ID
真实项目里经常是：
- UI 显示：北京 / 上海 / 深圳
- 业务值：110000 / 310000 / 440300（或 GUID / 枚举值）
这就是UserRole的主场：
cb->setItemData(0,110000,Qt::UserRole);intcode=cb->itemData(idx,Qt::UserRole).toInt();✅你得到的好处：
UI 文案随便改，业务值不受影响；UI 和逻辑彻底解耦。
07｜下拉也能“分组”：insertSeparator()
想做“常用 / 其他”“最近 / 全部”？
不用做两个 ComboBox，一条分隔线就够：
cb->addItem("常用：中文");cb->addItem("常用：英文");cb->insertSeparator(cb->count());cb->addItem("其他：日语");cb->addItem("其他：韩语");08｜自定义弹出 View：setView(QListView)
当你需要控制：
- 选择行为
- 性能（大列表）
- 样式/行高/后续 delegate
setView()就很好用：
auto*view=newQListView(cb);view->setSelectionMode(QAbstractItemView::SingleSelection);view->setUniformItemSizes(true);cb->setView(view);09｜带图标条目：addItem(QIcon, text)（状态/级别/主题选择神器）
QIcon warn=style()->standardIcon(QStyle::SP_MessageBoxWarning);cb->addItem(warn,"Warning");✅典型用途：
日志级别、告警等级、主题模式、状态选择。
10｜可编辑时校验：Validator 要加在lineEdit()上
这个坑很常见：
ComboBox 可编辑时，本质输入框是lineEdit()。
cb->setEditable(true);cb->lineEdit()->setValidator(newQIntValidator(0,999,cb));✅你得到的好处：
输入从源头就被限制，不用后面反复弹错误提示。
11｜输入即弹出：type-to-popup（体验立刻起飞）
很多“可搜索下拉”的关键体验就是：
一输入就弹候选，不用再点小箭头。
connect(cb->lineEdit(),&QLineEdit::textEdited,this,[=](constQString&t){if(!cb->view()->isVisible()&&!t.isEmpty())cb->showPopup();});配合第 04 节的QCompleter，基本就是“搜索下拉框”的雏形了。
12｜工程级细节：禁用滚轮误触（参数面板必备）
参数面板最怕的一类事故：
用户滚动页面，鼠标刚好悬停在 ComboBox 上 → 值被滚轮改掉。
你的做法很干净：用事件过滤器吃掉 Wheel。
classNoWheelFilter:publicQObject{protected:booleventFilter(QObject*,QEvent*ev)override{if(ev->type()==QEvent::Wheel)returntrue;returnQObject::eventFilter(obj,ev);}};cb->installEventFilter(newNoWheelFilter(cb));✅典型用途：
工业界面、参数面板、配置页、任何“改错代价很大”的 UI。
✅ 下载链接
我把完整可运行 Demo 打包好了：直接拷进工程即可运行（含状态区 + 12 个功能分组）。
下载链接：
通过网盘分享的文件：QComboBox
链接: https://pan.baidu.com/s/1ZQHCMc-TLvED6cuWR3W2XA?pwd=jkcf 提取码: jkcf
)
