Qt6 QML可编辑ComboBox修改模型项后弹出列表不更新

开发者阿泽

2026-9-1

问题产生原因

Qt6 QML的ListModel对项属性修改的信号触发逻辑有明确区分：

执行append()、remove()、insert()这类结构性修改操作时，模型会自动发送行列增删类信号，所有绑定该模型的视图都会收到通知触发刷新，因此ComboBox下拉列表可以正常更新。
直接通过get(index).属性名 = 新值的方式修改现有项属性时，仅会更新模型内部存储的属性值，不会自动发送dataChanged数据更新信号。

ComboBox的下拉弹出面板是独立的委托视图，完全依赖模型抛出的变更信号刷新内容，收不到dataChanged信号就会持续渲染旧值；而ComboBox本身的输入框显示逻辑是读取当前索引对应的属性内存值，因此能拿到修改后的新值，就出现了输入框显示正确、下拉列表显示旧值的不一致现象。

可用修复方案

优先使用ListModel原生的set()方法修改项属性：该方法在完成属性值更新后会自动触发对应索引、对应角色的dataChanged信号，无需额外手动处理，是最简洁的实现方式，修改后的onAccepted逻辑如下：

onAccepted:
{
  console.log('onAccepted() editText:', editText);
  model.set(currentIndex, {text: editText});
}

如果已经使用get()方式修改了属性，可以手动调用模型接口触发数据变更通知，告知下拉列表对应位置的内容需要刷新：

onAccepted:
{
  console.log('onAccepted() editText:', editText);
  const targetIndex = currentIndex;
  model.get(targetIndex).text = editText;
  // 参数依次为：变更起始索引、变更结束索引、变更涉及的角色列表
  model.dataChanged(model.index(targetIndex, 0), model.index(targetIndex, 0), ["text"]);
}