在 Qt QTableView 单元格中嵌入控件的实现方法

在使用 Qt 的 QTableView 组件时，有时需要在单元格中显示可交互的控件，如复选框、按钮或下拉框。常见的实现方式有三种：使用自定义代理（QItemDelegate）、直接调用 setIndexWidget，以及结合布局管理器使用 setIndexWidget 与容器控件。下面分别介绍这几种方法。

1. 使用自定义代理 QItemDelegate

通过继承 QItemDelegate 并重写其 createEditor 方法，可以在用户进入编辑模式时动态创建控件。这种方式适用于需要按条件触发编辑行为的场景，例如双击单元格才弹出控件。

核心函数说明：

• createEditor：创建用于编辑的控件实例，并放置在对应单元格上方。
• setEditorData：将模型中的数据加载到编辑控件中。
• setModelData：将编辑控件中的当前值写回数据模型。

以下是一个仅重写 createEditor 的简单代理类示例，用于在特定列插入复选框：

#ifndef CUSTOMDELEGATE_H
#define CUSTOMDELEGATE_H

#include <QItemDelegate>
#include <QCheckBox>

class CustomDelegate : public QItemDelegate
{
    Q_OBJECT

public:
    explicit CustomDelegate(QObject *parent = nullptr);

    QWidget* createEditor(QWidget *parent,
                          const QStyleOptionViewItem &option,
                          const QModelIndex &index) const override;
};

#endif // CUSTOMDELEGATE_H

#include "CustomDelegate.h"

CustomDelegate::CustomDelegate(QObject *parent)
    : QItemDelegate(parent)
{
}

QWidget* CustomDelegate::createEditor(QWidget *parent,
                                      const QStyleOptionViewItem &option,
                                      const QModelIndex &index) const
{
    if (index.isValid() && index.column() == 0) {
        QCheckBox *box = new QCheckBox(parent);
        return box;
    }
    return QItemDelegate::createEditor(parent, option, index);
}

该方法的主要限制是控件仅在进入编辑状态（如双击）时才可见，不适合需要常驻控件的界面需求。

2. 使用 setIndexWidget 直接嵌入控件

更直接的方法是使用 QAbstractItemView::setIndexWidget 函数，在指定索引位置直接放置一个控件。此方式无需进入编辑模式即可显示控件，适合展示持续可操作的 UI 元素。

示例代码如下：

QStandardItemModel *model = new QStandardItemModel(this);
ui->tableView->setModel(model);

model->setHorizontalHeaderLabels(QStringList() << "姓名" << "性别" << "年龄");
model->setItem(0, 1, new QStandardItem("张三"));
model->setItem(1, 1, new QStandardItem("李四"));
model->setItem(2, 1, new QStandardItem("王二"));

// 创建复选框并绑定到 (0,0) 单元格
QCheckBox *checkbox = new QCheckBox();
model->setItem(0, 0, new QStandardItem()); // 占位项
ui->tableView->setIndexWidget(model->index(0, 0), checkbox);

虽然这种方法简单高效，但存在一个问题：控件默认左对齐且无法通过样式表精确控制内部位置。

3. setIndexWidget 结合布局管理器优化显示

为解决控件位置不可控的问题，可以将目标控件放入一个 QWidget 容器中，并为其设置布局（如 QHBoxLayout），从而灵活调整控件的对齐和边距。

改进后的代码如下：

// 创建容器和布局
QWidget *container = new QWidget();
QHBoxLayout *layout = new QHBoxLayout(container);
QCheckBox *checkbox = new QCheckBox(container);

// 设置左外边距以调整位置
layout->setContentsMargins(10, 0, 0, 0);
layout->addWidget(checkbox);
layout->setAlignment(Qt::AlignCenter); // 可选居中
container->setLayout(layout);

// 插入模型并绑定到视图
QStandardItem *item = new QStandardItem();
model->setItem(0, 0, item);
ui->tableView->setIndexWidget(model->index(0, 0), container);

通过引入容器和布局，不仅可以自由控制控件的位置，还能扩展为包含多个子控件的复合组件，提升界面灵活性。