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);