QListView、QListWidget、QTableView和QTableWidget

一、概念

在Qt框架中，QListView、QListWidget、QTableView和QTableWidget都是用于显示列表或表格数据的控件。
QListView是一个基于模型-视图架构的控件，用于展示列表形式的数据。它本身并不存储数据，而是依赖于一个QAbstractListModel或其子类（如QStandardItemModel）来提供数据。
QListWidget是一个更为直接、易于使用的列表控件，它内部已经集成了一个简单的模型，可以直接添加、删除和修改项。
QTableView是一个基于模型-视图架构的表格控件，用于展示表格形式的数据。同样需要关联一个QAbstractTableModel或其子类（如QStandardItemModel）来提供数据。
QTableWidget是一个集成模型的表格控件，可以直接添加、删除和修改单元格数据。

二、架构与数据模型‌

控件	架构类型	数据模型	继承关系
‌QListView‌	视图类	需外部模型（如 `QStandardItemModel`）‌	继承自 `QAbstractItemView`
‌QListWidget‌	Widget类	内置 `QListWidgetItem` 模型 ‌	继承自 `QListView`
‌QTableView‌	视图类	需外部模型（如 `QStandardItemModel、QSqlTableModel等`）‌	继承自 `QAbstractItemView`
‌QTableWidget‌	Widget类	内置 `QTableWidgetItem` 模型 ‌	继承自 `QTableView`

‌核心差异‌：

‌视图类‌（QListView/QTableView）与模型分离，需手动绑定模型，灵活性高，适合动态数据处理‌。
‌Widget类‌（QListWidget/QTableWidget）内置模型，直接操作项（Item），开发效率高，但扩展性受限‌。

三、功能与适用场景‌

控件	优势场景	局限性
‌QListView‌	动态数据绑定、多视图共享模型、自定义委托（Delegate）‌	需编写模型逻辑，开发复杂度较高‌
‌QListWidget‌	快速实现静态列表、少量数据展示（如配置项）‌	数据量大时性能下降，难以扩展‌
‌QTableView‌	多列数据展示、复杂表格逻辑（如数据库交互）‌	需自定义模型，代码量较大‌
‌QTableWidget‌	快速创建简单表格（如数据录入界面）‌	无法复用模型，数据量大时性能低‌

四、优势

‌视图类优势‌：

支持数据复用，适合动态更新和大数据量（如千级条目）‌。

可通过委托（Delegate）自定义项渲染和交互逻辑‌。
‌示例‌：

// QTableView 绑定数据库模型
QSqlTableModel *model = new QSqlTableModel;
model->setTable("employees");
QTableView *view = new QTableView;
view->setModel(model);

利用QItemDelegate，开发者可以为特定的列或者行定制绘制的样式，还可以定义编辑控件和编辑行为。它可以被用于处理复杂的编辑任务，比如自定义的下拉选择器或者复杂的输入验证。
Qt 提供了另外的基于组件的子类：QItemDelegate和 QStyledItemDelegate。默认的委托是 QStyledItemDelegate。二者的区别在于绘制和向视图提供编辑器的方式。QStyledItemDelegate使用当前样式绘制，并且能够使用 Qt Style Sheet，因此我们推荐在自定义委托时，使用 QStyledItemDelegate作为基类。
1）一个典型的使用QItemDelegate的场景是自定义表格视图中单元格的绘制和编辑方式。以下是一个简单的示例，展示了如何使用QItemDelegate来绘制一个带有特殊背景的单元格：

#include <QApplication>
#include <QTableView>
#include <QStandardItemModel>
#include <QItemDelegate>
 
class CustomDelegate : public QItemDelegate {
public:
    CustomDelegate(QObject *parent = nullptr) : QItemDelegate(parent) {}
 
    void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
        // 调用基类的paint方法绘制默认样式
        QItemDelegate::paint(painter, option, index);
        // 自定义绘制逻辑
        painter->setBrush(QColor("orange")); // 设置背景色
        painter->drawRect(option.rect); // 绘制矩形填充背景
    }
};
 
int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
 
    QTableView tableView;
    QStandardItemModel model(5, 3); // 创建5行3列的数据模型
    CustomDelegate delegate; // 创建委托对象
 
    tableView.setModel(&model);
    tableView.setItemDelegate(&delegate); // 设置自定义委托
 
    for (int row = 0; row < 5; ++row) {
        for (int column = 0; column < 3; ++column) {
            QModelIndex index = model.index(row, column, QModelIndex());
            model.setData(index, QString("Item %1").arg(row * 3 + column), Qt::DisplayRole);
        }
    }
 
    tableView.show();
    return app.exec();
}

2）要创建一个有效的自定义 QItemDelegate 类，需要考虑以下几点：
继承：从QStyledItemDelegate 继承，这取决于是否需要使用到Qt的样式系统。
构造函数：定义构造函数以接受可能的参数，例如颜色或字体。
重写方法：重写 createEditor 、 setEditorData 、 setModelData 、 updateEditorGeometry 、 paint 和 sizeHint 方法以提供自定义行为。
事件处理：处理事件（如鼠标事件和键盘事件），以实现特定的交互。
下面是一个自定义委托的示例，它提供了一个自定义的编辑器，用于编辑整数值：

class IntegerDelegate : public QStyledItemDelegate {
public:
    IntegerDelegate(QObject *parent = nullptr) : QStyledItemDelegate(parent) {}
 
    // 重写createEditor创建整数编辑器
    QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override {
        return new QSpinBox(parent);
    }
 
    // 将模型数据设置到编辑器中
    void setEditorData(QWidget *editor, const QModelIndex &index) const override {
        QSpinBox *spinBox = qobject_cast<QSpinBox *>(editor);
        if (!spinBox) return;
        spinBox->setValue(index.model()->data(index, Qt::EditRole).toInt());
    }
 
    // 将编辑器数据写回模型
    void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const override {
        QSpinBox *spinBox = qobject_cast<QSpinBox *>(editor);
        if (!spinBox) return;
        model->setData(index, spinBox->value(), Qt::EditRole);
    }
};

#include <QStyledItemDelegate>
#include <QSpinBox>
#include <QComboBox>
#include <QPainter>

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

    // 1. 创建编辑器控件
    QWidget* createEditor(QWidget* parent, const QStyleOptionViewItem& option, 
                         const QModelIndex& index) const override {
        if (index.column() == 0) { // 第一列使用数字输入框
            QSpinBox* editor = new QSpinBox(parent);
            editor->setRange(0, 100);
            return editor;
        } else if (index.column() == 1) { // 第二列使用下拉框
            QComboBox* editor = new QComboBox(parent);
            editor->addItems({"Option A", "Option B", "Option C"});
            return editor;
        }
        return QStyledItemDelegate::createEditor(parent, option, index);
    }

    // 2. 将模型数据加载到编辑器
    void setEditorData(QWidget* editor, const QModelIndex& index) const override {
        if (index.column() == 0) {
            int value = index.data(Qt::EditRole).toInt();
            QSpinBox* spinBox = qobject_cast<QSpinBox*>(editor);
            spinBox->setValue(value);
        } else if (index.column() == 1) {
            QString text = index.data(Qt::EditRole).toString();
            QComboBox* comboBox = qobject_cast<QComboBox*>(editor);
            comboBox->setCurrentText(text);
        } else {
            QStyledItemDelegate::setEditorData(editor, index);
        }
    }

    // 3. 将编辑器数据写回模型
    void setModelData(QWidget* editor, QAbstractItemModel* model,
                    const QModelIndex& index) const override {
        if (index.column() == 0) {
            QSpinBox* spinBox = qobject_cast<QSpinBox*>(editor);
            model->setData(index, spinBox->value(), Qt::EditRole);
        } else if (index.column() == 1) {
            QComboBox* comboBox = qobject_cast<QComboBox*>(editor);
            model->setData(index, comboBox->currentText(), Qt::EditRole);
        } else {
            QStyledItemDelegate::setModelData(editor, model, index);
        }
    }

    // 4. 调整编辑器位置和尺寸
    void updateEditorGeometry(QWidget* editor, const QStyleOptionViewItem& option,
                             const QModelIndex& index) const override {
        editor->setGeometry(option.rect.adjusted(2, 2, -2, -2)); // 边缘留2像素空隙
    }

    // 5. 自定义绘制逻辑
    void paint(QPainter* painter, const QStyleOptionViewItem& option,
              const QModelIndex& index) const override {
        if (index.column() == 2) { // 第三列绘制进度条
            int progress = index.data(Qt::UserRole).toInt();
            QStyleOptionProgressBar progressBarOption;
            progressBarOption.rect = option.rect.adjusted(5, 5, -5, -5);
            progressBarOption.minimum = 0;
            progressBarOption.maximum = 100;
            progressBarOption.progress = progress;
            progressBarOption.text = QString::number(progress) + "%";
            progressBarOption.textVisible = true;
            
            QApplication::style()->drawControl(QStyle::CE_ProgressBar, 
                                              &progressBarOption, painter);
        } else {
            QStyledItemDelegate::paint(painter, option, index);
        }
    }

    // 6. 控制项尺寸
    QSize sizeHint(const QStyleOptionViewItem& option,
                  const QModelIndex& index) const override {
        if (index.column() == 2) { // 进度列需要更大高度
            return QSize(200, 30); 
        }
        return QStyledItemDelegate::sizeHint(option, index);
    }
};

Widget类优势‌：

简化操作（如 addItem()、setItem()），适合快速开发‌。

支持直接嵌入自定义控件（如 setItemWidget()）‌。
‌示例‌：

// QListWidget 添加带图标的项
QListWidgetItem *item = new QListWidgetItem("Text");
item->setIcon(QIcon("icon.png"));
listWidget->addItem(item);