QML中ListView绑定CheckBox后，Model setProperty方法仅首次点击按钮生效的问题

问题描述 #

我有一个填充了CheckBox的ListView，希望通过点击按钮来改变CheckBox的状态，但遇到了一个奇怪的问题：首次点击按钮时状态会正常改变，CheckBox被勾选，但手动取消勾选后再次点击按钮，完全无法重新勾选该CheckBox。这个问题在Qt 6.3（Windows 10系统）、Android、iOS及桌面端均存在，测试Qt 5.15.2时也出现相同情况。

我的代码如下：

import QtQuick
import QtQuick.Controls 2.15
Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")
    ListView {
        id: mylist
        width: parent.width
        height: 300
        anchors {
            top: parent.top
            left: parent.left
            right: parent.right
            bottom: change_state.top
            bottomMargin: 20
        }
        model: ListModel {
            id: mymodel
            ListElement { mystatus : false }
            ListElement { mystatus : false }
            ListElement { mystatus : false }
        }
        delegate: Rectangle {
            height: 50
            width: parent.width
            CheckBox {
                id: cb
                checked: mystatus
                anchors.fill: parent
                text: "State"
            }
        }
    }
    Button {
        id: change_state
        anchors { bottom: parent.bottom }
        text: "Change status"
        onClicked: {
            mymodel.setProperty(1, "mystatus", true)
            console.log("PRESSED")
        }
    }
}

问题原因与解决方案 #

这个问题的核心在于手动操作CheckBox会打破它和Model属性的绑定关系：在QML中，当你直接修改一个通过绑定赋值的属性时（比如手动点击CheckBox改变checked状态），默认会解除原有的绑定。这就导致后续修改Model中的mystatus时，CheckBox无法再同步更新状态。

这里提供两种可靠的解决思路：

方案1：使用Binding组件强制维持绑定 #

我们可以通过Binding组件明确指定checked属性与mystatus的绑定关系，即使手动操作CheckBox，绑定也不会被解除。同时添加点击事件同步更新Model数据，确保双向同步：

delegate: Rectangle {
    height: 50
    width: parent.width
    CheckBox {
        id: cb
        text: "State"
        anchors.fill: parent
        // 用Binding组件强制维持和Model的绑定
        Binding {
            target: cb
            property: "checked"
            value: mystatus
            restoreMode: Binding.RestoreBinding
            when: true
        }
        // 手动点击时同步更新Model数据
        onClicked: mymodel.setProperty(index, "mystatus", cb.checked)
    }
}

方案2：让Model成为唯一状态源 #

另一种更简洁的思路是，完全让Model作为状态的唯一数据源，CheckBox的点击事件只负责修改Model，而非直接修改自身的checked属性。这样checked始终通过绑定同步Model状态，不会出现绑定断裂的问题：

delegate: Rectangle {
    height: 50
    width: parent.width
    CheckBox {
        id: cb
        checked: mystatus
        anchors.fill: parent
        text: "State"
        // 点击时直接修改Model，通过绑定自动同步状态
        onClicked: mymodel.setProperty(index, "mystatus", !mystatus)
    }
}

完整修改代码（方案2示例） #

import QtQuick
import QtQuick.Controls 2.15
Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")
    ListView {
        id: mylist
        width: parent.width
        height: 300
        anchors {
            top: parent.top
            left: parent.left
            right: parent.right
            bottom: change_state.top
            bottomMargin: 20
        }
        model: ListModel {
            id: mymodel
            ListElement { mystatus : false }
            ListElement { mystatus : false }
            ListElement { mystatus : false }
        }
        delegate: Rectangle {
            height: 50
            width: parent.width
            CheckBox {
                id: cb
                checked: mystatus
                anchors.fill: parent
                text: "State"
                onClicked: mymodel.setProperty(index, "mystatus", !mystatus)
            }
        }
    }
    Button {
        id: change_state
        anchors { bottom: parent.bottom }
        text: "Change status"
        onClicked: {
            mymodel.setProperty(1, "mystatus", true)
            console.log("PRESSED")
        }
    }
}

现在无论你手动取消CheckBox多少次，点击按钮都能正常重新勾选，状态同步完全正常。

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