当前位置: 首页 > article >正文

QListView、QListWidget、QTableView和QTableWidget

一、概念

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

二、架构与数据模型

控件架构类型数据模型继承关系
QListView视图类需外部模型(如 QStandardItemModel)‌继承自 QAbstractItemView
QListWidgetWidget类内置 QListWidgetItem 模型 ‌继承自 QListView
QTableView视图类需外部模型(如 QStandardItemModel、QSqlTableModel等)‌继承自 QAbstractItemView
QTableWidgetWidget类内置 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);

http://www.kler.cn/a/589811.html

相关文章:

  • 【MySQL】MySQL是如何处理请求的?
  • JMeter 性能测试
  • P41-指针进阶1、2
  • 基于 YOLOv8 和 PyQt5 的火焰、烟雾检测
  • Grokking System Design 系统设计面试问题
  • 用UML搞懂ASPICE(6)过程能力确定的能力维度
  • [蓝桥杯 2023 省 B] 飞机降落
  • WinForm基础知识1-20
  • Unity Google登录
  • 深入解析音频编解码器(Audio CODEC):硬件、接口与驱动开发
  • WireShark自动抓包
  • 【ProjectDiscovery 生态中核心工具 Subfinder、Httpx、Katana 和 Nuclei 的基础使用教程】
  • 【协作开发】低成本一键复刻github的gitea
  • 二、vtkCommand的使用
  • 2025-03-17 学习记录--C/C++-PTA 习题4-3 求分数序列前N项和
  • 大语言模型中的 Function Calling
  • Navicat又放大招,接入DeepSeek后AI写SQL
  • 2025-03-17 NO.1 Quest3 开发环境配置教程
  • 蓝桥杯备考:贪心+思维题 之 zzc种田
  • 理解矩阵乘以向量如何“将空间进行了扭曲”