QML非可编辑ComboBox选中项滚动出视图后恢复旧值如何解决

问题核心原因 #

TableView的单元格代理（Delegate）采用复用机制，滚动出可视区域的ComboBox控件会被回收，重新滚动回视野时会从绑定的底层数据源读取数据重新渲染。之前仅修改了ComboBox控件本身的选中状态，没有将新值同步回数据源，因此控件重载后会自动恢复为旧值。

正确实现步骤 #

1. 确保后端数据模型可读写 #

需要使用支持读写的Qt数据模型，如QStandardItemModel，或者自定义继承QAbstractTableModel的子类，必须正常实现setData()方法，用于接收前端回传的选中值并更新内部存储。
Python侧自定义模型示例：

from PyQt5.QtCore import QAbstractTableModel, Qt, QVariant

class TableModel(QAbstractTableModel):
    def __init__(self, data):
        super().__init__()
        self._data = data # 内部存储二维列表，保存表格所有数据
    
    def rowCount(self, parent=None):
        return len(self._data)
    
    def columnCount(self, parent=None):
        return len(self._data[0]) if self._data else 0
    
    def data(self, index, role=Qt.DisplayRole):
        if not index.isValid():
            return QVariant()
        if role in (Qt.DisplayRole, Qt.EditRole):
            return self._data[index.row()][index.column()]
        return QVariant()
    
    def setData(self, index, value, role=Qt.EditRole):
        if role == Qt.EditRole and index.isValid():
            self._data[index.row()][index.column()] = value
            self.dataChanged.emit(index, index, [Qt.DisplayRole, Qt.EditRole])
            return True
        return False

2. QML侧ComboBox正确绑定信号 #

非可编辑的ComboBox选中值变化时会触发activated信号，无需监听onDisplayTextChanged或者手动调用onAccepted（onAccepted仅在ComboBox设为可编辑状态，用户手动输入后按回车时触发，非编辑场景不会触发）。
QML侧ComboBox代码示例：

TableView {
    id: tableView
    model: tableModel // 绑定Python侧传入的自定义模型
    delegate: ComboBox {
        id: comboBox
        model: ["选项1", "选项2", "选项3"] // 替换为实际下拉选项列表
        // 初始化时从后端模型读取当前值
        Component.onCompleted: {
            currentText = model.data(index, Qt.EditRole)
        }
        // 选中变化时同步值回后端模型
        onActivated: {
            model.setData(index, currentText, Qt.EditRole)
        }
    }
}

注意事项 #

• 所有业务数据必须存储在后端Model层，不要存储在前端视图控件本身，遵循Qt MVC设计规范即可完全避免控件复用导致的数据丢失问题
• 如果使用QStandardItemModel无需自定义setData，直接调用item.setData()或者model.setData()即可完成值更新

内容的提问来源于stack exchange，提问作者SCP3008