QT TreeModel中递归设置可勾选子项状态的实现问题

原代码的问题 #

• 仅处理当前项的直接子项，未递归处理更深层级的子节点，导致深层子项无法同步勾选/取消勾选状态
• 手动修改子项数据后，未触发递归逻辑处理子项的子节点，也未复用setData内的校验逻辑（比如isBooleanColumn判断）
• 创建索引时未正确关联父索引，直接调用createIndex可能生成无效索引，导致视图无法识别状态更新

修正方案 #

核心思路是通过**递归调用setData**处理所有层级的子项，既复用现有数据校验逻辑，又确保所有子项同步状态，同时用model->index()创建有效索引：

bool TreeModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (role != Qt::EditRole && role != Qt::CheckStateRole)
        return false;

    TreeItem *item = getItem(index);
    bool result = false;

    if (role == Qt::CheckStateRole && isBooleanColumn(index)) {
        Qt::CheckState eChecked = static_cast<Qt::CheckState>(value.toInt());
        bool bNewValue = eChecked == Qt::Checked;
        result = item->setData(index.column(), bNewValue);

        // 递归遍历并同步所有子项的勾选状态
        auto recursiveToggle = [this, role](auto &&self, const QModelIndex &parentIdx, bool checked) -> void {
            int childCount = this->rowCount(parentIdx);
            for (int row = 0; row < childCount; ++row) {
                // 用model的index()创建有效子项索引，自动关联父索引
                QModelIndex childIdx = this->index(row, parentIdx.column(), parentIdx);
                // 调用setData处理子项，自动触发自身的校验与递归
                this->setData(childIdx, checked ? Qt::Checked : Qt::Unchecked, role);
                // 递归处理子项的子项
                self(self, childIdx, checked);
            }
        };
        recursiveToggle(recursiveToggle, index, bNewValue);

    } else {
        result = item->setData(index.column(), value);
    }

    if (result) {
        // 必须包含CheckStateRole，否则视图不会更新勾选状态
        emit dataChanged(index, index, {Qt::DisplayRole, Qt::EditRole, Qt::CheckStateRole});
    }

    return result;
}

关键修正点说明 #

1. 递归逻辑：用lambda递归函数遍历所有层级子项，确保每一层的子节点都被同步状态
2. 有效索引创建：使用model->index(row, column, parentIndex)生成子项索引，该方法会自动维护索引的父子关联，避免无效索引问题
3. 复用setData逻辑：递归调用setData而非直接修改TreeItem，确保isBooleanColumn等校验逻辑被执行，同时自动触发子项的递归处理
4. 修正dataChanged角色：添加Qt::CheckStateRole，通知视图更新勾选状态（原代码仅包含显示和编辑角色，会导致勾选状态不刷新）

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