Qt6.5 QML TreeView单击清除选中问题排查与解决请求

问题原因 #

TreeView继承自TableView，其默认交互逻辑将单击操作绑定到「清除选中状态+设置当前项」的行为上。当你通过双击手动选中项后，任意单击（包括空白区域、已选中/未选中项）都会触发内部调用QItemSelectionModel::select，传入空selection和Clear命令，直接清除现有选中状态。此外，未显式配置selectionMode会放大这种逻辑冲突，因为默认选择模式下没有区分「导航（current属性）」和「选中（selected属性）」的交互边界。

修复方案 #

方案1：QML层拦截事件并配置选择模式 #

通过修改selectionMode和拦截单击事件，阻止默认的清除逻辑：

TreeView {
    model: MySingletonController.model
    selectionBehavior: TableView.SelectRows
    // 根据需求设置选择模式，比如单选或多选
    selectionMode: SelectionMode.SingleSelection
    selectionModel: ItemSelectionModel {
        model: model
    }
    delegate: TreeViewDelegate {
        required property int index
        contentItem: Text {
            text: parent.index + " " + parent.current + " " + parent.selected
        }
        // 拦截单击事件，阻止TreeView执行默认清除操作
        onClicked: event.accepted = true
        onDoubleClicked: {
            selectionModel.select(
                treeView.index(index, 0),
                ItemSelectionModel.Select
            )
        }
    }
}

• selectionMode设为SingleSelection或MultiSelection，明确选择规则；
• onClicked中设置event.accepted = true，截断事件传递，避免TreeView触发默认的清除选中行为。

方案2：C++层自定义ItemSelectionModel #

如果需要更精细的控制，可继承QItemSelectionModel重写select方法，过滤不必要的清除命令：

#include <QItemSelectionModel>

class CustomSelectionModel : public QItemSelectionModel
{
    Q_OBJECT
public:
    explicit CustomSelectionModel(QAbstractItemModel *model, QObject *parent = nullptr)
        : QItemSelectionModel(model, parent) {}

protected:
    void select(const QItemSelection &selection, SelectionFlags command) override {
        // 过滤空选择范围且命令为Clear的情况
        if (selection.isEmpty() && (command & Clear)) {
            return;
        }
        QItemSelectionModel::select(selection, command);
    }
};

将该类注册到QML后使用：

TreeView {
    model: MySingletonController.model
    selectionBehavior: TableView.SelectRows
    selectionModel: CustomSelectionModel {
        model: model
    }
    delegate: TreeViewDelegate {
        required property int index
        contentItem: Text {
            text: parent.index + " " + parent.current + " " + parent.selected
        }
        onDoubleClicked: {
            selectionModel.select(
                treeView.index(index, 0),
                ItemSelectionModel.Select
            )
        }
    }
}

内容的提问来源于stack exchange，提问作者Y.F.