Qt中如何让一个视图显示复选框，另一个视图不显示？

为什么你之前的方法无效 #

你之前尝试派生视图类重写flags()是方向错误——flags()是QAbstractItemModel派生类的成员函数，视图本身并不实现这个方法，它只会调用当前绑定模型的flags()。所以两个视图用同一个模型对象时，必然都会使用模型的flags()逻辑，派生视图的重写不会生效。

无需新建视图类的两种解决方案 #

方案1：使用自定义代理（QStyledItemDelegate） #

这是Qt官方推荐的方式，通过给目标视图设置自定义代理，强制在该视图中渲染复选框，无需修改原模型和视图类。

自定义代理代码

#include <QStyledItemDelegate>
#include <QStyleOptionViewItem>
#include <QEvent>

class CheckableItemDelegate : public QStyledItemDelegate
{
    Q_OBJECT
public:
    explicit CheckableItemDelegate(QObject* parent = nullptr) 
        : QStyledItemDelegate(parent) {}

    // 初始化样式选项，强制添加复选框标识
    void initStyleOption(QStyleOptionViewItem* option, const QModelIndex& index) const override
    {
        QStyledItemDelegate::initStyleOption(option, index);
        option->features |= QStyleOptionViewItem::HasCheckIndicator;
        // 从模型的Qt::CheckStateRole获取复选框状态，默认未选中
        option->checkState = static_cast<Qt::CheckState>(
            index.data(Qt::CheckStateRole).value<int>(static_cast<int>(Qt::Unchecked))
        );
    }

    // 处理复选框的点击交互，更新模型状态
    bool editorEvent(QEvent* event, QAbstractItemModel* model, 
                     const QStyleOptionViewItem& option, const QModelIndex& index) override
    {
        if ((event->type() == QEvent::MouseButtonRelease || event->type() == QEvent::KeyRelease)
            && option.features & QStyleOptionViewItem::HasCheckIndicator)
        {
            Qt::CheckState currentState = static_cast<Qt::CheckState>(
                model->data(index, Qt::CheckStateRole).value<int>(static_cast<int>(Qt::Unchecked))
            );
            Qt::CheckState newState = (currentState == Qt::Checked) ? Qt::Unchecked : Qt::Checked;
            return model->setData(index, newState, Qt::CheckStateRole);
        }
        return QStyledItemDelegate::editorEvent(event, model, option, index);
    }
};

使用方式

给需要显示复选框的视图绑定这个代理，另一个视图用默认代理即可：

// 假设你已经创建了原模型MyListModel* model;
CheckableItemDelegate* checkDelegate = new CheckableItemDelegate(this);
ui->checkableListView->setItemDelegate(checkDelegate);

// 另一个视图直接用原模型，无需额外设置
ui->normalListView->setModel(model);

方案2：使用身份代理模型（QIdentityProxyModel） #

通过包装原模型，给需要复选框的视图提供一个带复选框逻辑的代理模型，原模型保持不变。

自定义代理模型代码

#include <QIdentityProxyModel>

class CheckableProxyModel : public QIdentityProxyModel
{
    Q_OBJECT
public:
    explicit CheckableProxyModel(QObject* parent = nullptr) 
        : QIdentityProxyModel(parent) {}

    // 重写flags，添加可勾选标识
    Qt::ItemFlags flags(const QModelIndex& index) const override
    {
        Qt::ItemFlags baseFlags = QIdentityProxyModel::flags(index);
        return baseFlags | Qt::ItemIsUserCheckable;
    }

    // 提供复选框状态数据
    QVariant data(const QModelIndex& index, int role) const override
    {
        if (role == Qt::CheckStateRole)
        {
            // 优先取原模型的状态，默认未选中
            QVariant state = QIdentityProxyModel::data(index, Qt::CheckStateRole);
            return state.isValid() ? state : Qt::Unchecked;
        }
        return QIdentityProxyModel::data(index, role);
    }

    // 处理复选框状态更新
    bool setData(const QModelIndex& index, const QVariant& value, int role) override
    {
        if (role == Qt::CheckStateRole)
        {
            return QIdentityProxyModel::setData(index, value, role);
        }
        return QIdentityProxyModel::setData(index, value, role);
    }
};

使用方式

给需要复选框的视图绑定代理模型，另一个视图直接用原模型：

// 原模型
MyListModel* model = new MyListModel(this);

// 代理模型包装原模型
CheckableProxyModel* proxyModel = new CheckableProxyModel(this);
proxyModel->setSourceModel(model);

// 带复选框的视图用代理模型
ui->checkableListView->setModel(proxyModel);

// 普通视图用原模型
ui->normalListView->setModel(model);

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