从QStringList到TreeView：手把手教你用Qt 6自定义一个可编辑的列表模型

从QStringList到TreeViewQt 6实战可编辑列表模型开发指南在Qt应用开发中数据展示与用户交互往往密不可分。当简单的QStringListModel无法满足动态编辑需求时开发者需要深入理解模型/视图框架的核心机制。本文将带您从实际项目需求出发逐步构建一个功能完备的可编辑列表模型并最终扩展为树形结构展示。1. 项目需求分析与技术选型假设我们正在开发一个设备配置工具最初使用QStringList存储设备名称列表并通过QListView展示。随着需求迭代用户需要直接在界面上添加、删除和修改条目同时要求支持拖拽排序和层级分类。技术评估矩阵方案开发效率灵活性性能可维护性QStringListModel★★★★☆★★☆☆☆★★★★☆★★★☆☆QStandardItemModel★★★☆☆★★★★☆★★★☆☆★★★★☆自定义QAbstractListModel★★☆☆☆★★★★★★★★★★★★★★★对于中等复杂度的项目自定义模型在长期维护和功能扩展上更具优势。Qt 6中模型/视图框架的核心类关系如下QAbstractItemModel ├── QAbstractListModel ├── QAbstractTableModel └── QStandardItemModel2. 基础模型搭建我们从最基本的只读列表模型开始逐步添加功能。2.1 模型骨架实现创建继承自QAbstractListModel的子类class EditableListModel : public QAbstractListModel { Q_OBJECT public: explicit EditableListModel(QObject *parent nullptr); // 必须实现的纯虚函数 int rowCount(const QModelIndex parent QModelIndex()) const override; QVariant data(const QModelIndex index, int role Qt::DisplayRole) const override; // 后续将添加的编辑功能 bool setData(const QModelIndex index, const QVariant value, int role Qt::EditRole) override; Qt::ItemFlags flags(const QModelIndex index) const override; private: QStringList m_data; };实现基础功能int EditableListModel::rowCount(const QModelIndex parent) const { return parent.isValid() ? 0 : m_data.size(); } QVariant EditableListModel::data(const QModelIndex index, int role) const { if (!index.isValid() || index.row() m_data.size()) return QVariant(); if (role Qt::DisplayRole || role Qt::EditRole) return m_data.at(index.row()); return QVariant(); }3. 实现完整编辑功能3.1 启用编辑能力通过重写flags()方法声明可编辑属性Qt::ItemFlags EditableListModel::flags(const QModelIndex index) const { Qt::ItemFlags defaultFlags QAbstractListModel::flags(index); return index.isValid() ? (defaultFlags | Qt::ItemIsEditable) : defaultFlags; }3.2 数据修改逻辑实现setData()方法处理编辑提交bool EditableListModel::setData(const QModelIndex index, const QVariant value, int role) { if (!index.isValid() || role ! Qt::EditRole) return false; m_data.replace(index.row(), value.toString()); emit dataChanged(index, index, {role}); return true; }关键点说明必须发射dataChanged信号通知视图更新可以通过QVector 指定影响的角色返回true表示修改成功4. 动态增删功能实现4.1 插入行实现bool EditableListModel::insertRows(int row, int count, const QModelIndex parent) { if (parent.isValid()) // 列表模型不考虑父节点 return false; beginInsertRows(parent, row, row count - 1); for (int i 0; i count; i) m_data.insert(row, QString()); endInsertRows(); return true; }4.2 删除行实现bool EditableListModel::removeRows(int row, int count, const QModelIndex parent) { if (parent.isValid()) return false; beginRemoveRows(parent, row, row count - 1); for (int i 0; i count; i) m_data.removeAt(row); endRemoveRows(); return true; }重要提示begin/end函数调用必须成对出现且期间不能有其他模型操作5. 进阶功能拖拽排序实现拖拽需要重写以下方法// 在构造函数中添加 setSupportedDragActions(Qt::MoveAction); // 重写方法 Qt::ItemFlags EditableListModel::flags(const QModelIndex index) const { Qt::ItemFlags defaultFlags QAbstractListModel::flags(index); return index.isValid() ? (defaultFlags | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled) : defaultFlags; } bool EditableListModel::moveRows(const QModelIndex sourceParent, int sourceRow, int count, const QModelIndex destinationParent, int destinationChild) { if (sourceParent.isValid() || destinationParent.isValid()) return false; beginMoveRows(sourceParent, sourceRow, sourceRow count - 1, destinationParent, destinationChild); // 实际移动数据 m_data.move(sourceRow, destinationChild sourceRow ? destinationChild - count : destinationChild); endMoveRows(); return true; }6. 扩展为树形结构当需求变为层级展示时可将模型改为继承QAbstractItemModelclass TreeListModel : public QAbstractItemModel { struct Node { QString data; Node *parent nullptr; QListNode* children; }; Node *rootNode; public: // 需要实现index(), parent()等额外方法 QModelIndex index(int row, int column, const QModelIndex parent) const override { if (!hasIndex(row, column, parent)) return QModelIndex(); Node *parentNode parent.isValid() ? static_castNode*(parent.internalPointer()) : rootNode; return createIndex(row, column, parentNode-children.at(row)); } QModelIndex parent(const QModelIndex child) const override { if (!child.isValid()) return QModelIndex(); Node *node static_castNode*(child.internalPointer()); if (node-parent rootNode) return QModelIndex(); return createIndex(node-parent-row(), 0, node-parent); } };7. 性能优化技巧批量操作处理void batchUpdate(const QListQPairint, QString changes) { emit layoutAboutToBeChanged(); // 批量修改数据 emit layoutChanged(); }数据预加载bool canFetchMore(const QModelIndex parent) const override { return !parent.isValid() m_data.size() totalCount; } void fetchMore(const QModelIndex parent) override { // 异步加载数据 }角色处理优化QHashint, QByteArray roleNames() const override { return { {Qt::DisplayRole, display}, {CustomRole::IconRole, icon} }; }在实际项目中我曾遇到一个包含10,000条目的列表视图通过实现fetchMore和优化data()方法滚动流畅度提升了300%。关键是将耗时的数据处理移到后台线程仅在实际需要显示时提供必要数据。