Qt Model/View 学习(2) - QModelIndex索引模型数据

最新推荐文章于 2025-03-29 11:56:05 发布
最新推荐文章于 2025-03-29 11:56:05 发布
阅读量7.6k 收藏 77
点赞数 51
分类专栏： Qt Model/View 文章标签： qt c++ mvc
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Copperxcx/article/details/122044768
版权
本文深入探讨Qt中的Model/View框架，重点介绍了Model相关类及其核心——QAbstractItemModel。此外，还详细解析了QModelIndex的使用方法，帮助读者更好地理解和使用Qt的Model/View框架。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

目录

0. 前言

上一篇文章讲了Qt中Model/View框架的起源（和给人的优越感 ），以及它大概是怎么个思路，最后花了不少篇幅讲了为什么要使用Model/View，现在想想多是在给自己打气，好坚持学下去👻。

本文开始介绍有关函数接口了，既然数据Data是用户自定义的，那就从Model开始介绍。

系列文章回顾：
Qt Model/View 学习(1) - 是什么和为什么？

1. Model有关类

先上一张Qt有关Model类的UML类图，空心箭头表示泛化关系，也就是派生类指向基类。如果想了解更多一点关于UML类图的知识，可以移步这篇文章。
在这里插入图片描述
图中C位自然是QAbstractItemModel了，它继承自QObject获得了信号和槽机制，派生出了诸多Model类，但其中核心就2个：

  • QAbstractListModel：提供一维矩阵模型的抽象基类；既然是抽象类，那我们只能派生自己的类才能使用；
  • QAbstractTableModel：提供表格模型的抽象基类；

其它的有：

  • QFileSystemModel：提供本地文件系统的数据模型，使用场景十分受限，也可以先不用过多理会；
  • QAbstractProxyModel：提供排序、过滤、或其它数据处理任务的代理模型，暂时可以不用过多理会；
  • QStandardItemModel：提供了一种使用控件的Model类，换言之，它Model了，但没有完全Model，在学习Model/View的路上可以不用过多理会；
  • QDirModel：官方建议使用性能更好的QFileSystemModel，那可以不用过多理会；

所以，虽然继承树似乎内容庞大，但我们只要搞懂QAbstractListModel和QAbstractTableModel这俩，就能掌握Model的精髓了，好耶！

而这俩，从名字看就很简单：一个一维数组一个二维数组，而且打开这两个类的文档，篇幅极少，滚动条那么大一个，就这？

在这里插入图片描述

2. Model索引：QModelIndex

先别着急膨胀，QAbstractListModel和QAbstractTableModel的文档内容少是因为大部分内容都在QAbstractItemModel中实现了，而打开QAbstractItemModel类的文档就又有些劝退了……

不过换言之，只要掌握了QAbstractItemModel，就能掌握Model的精髓了。

后续将用 “Model类” 来指代从 QAbstractItemModel派生的类；

在上一篇文章中讲过，Model是对数据的解析模型，比如20个散装变量，可以被解析成一个4*5的矩阵。而如何去索引矩阵中的数据就是重点了，这需要介绍本小节的主角QModelIndex了，先上一张图：
在这里插入图片描述
以下是核心解释，看完这里基本就掌握索引了：

  1. QModelIndex是Model类的索引，基本特征是二维索引，通过row()和column()方法获取其位置；

  2. 但它不是纯二维索引，还提供了parent()和child()方法获取上层节点和下层节点。还提供了sibling()方法，提供row和column的偏移量来获取同一层的兄弟节点；

  3. 一般使用Model类的createIndex()方法创建索引，需要提供row，column和parent；

  4. 使用构造函数创建的QModelIndex对象是无效的，无效索引通常被用于指代最顶层对象的parent节点，可通过isValid()方法来判断是否有效，有效表示该对象是某个Model对象的有效索引；

  5. 要获取一个Model类的索引时，使用index()方法获取，但很遗憾该接口一般不是公开的；

    如果设为公开，或许会比较破坏封装性；

  6. QModelIndex对象最好是随用随取，不要指望某个QModelIndex在调用了其它Model函数之后还能起作用，这里暗示QModelIndex是“对位不对人”的，如果希望“对人不对位”，可以使用QPersistentModelIndex类；

    但尽管使用QPersistentModelIndex类也最好先用isValid()断一下，因为有可能索引的对象人没了。

最后再补一嘴，为什么Model类的索引被设计成这样？

简单来说，为了适应常见的数据结构：树结构 和 矩阵结构。QModelIndex的行和列索引使其能够支持矩阵结构，parent()和child()接口使其能够支持树结构。

下图是官方用来说明三种常用模型（列表、表格、树）的图。放到这里来参考的原因是QModelIndex的表示能力是大于以下三种模型的，因为每个QModelIndex对象都可以作为parent，对于每个parent，都可以索引其二维孩子child。
在这里插入图片描述
搞清楚如何索引之后，Model类基本就 攻略了30% 了，是不是很简单呢？

3. 小结

  1. Model类主要搞懂QAbstractItemModel即可，搞明白之后由该类派生的QAbstractListModel和QAbstractTableModel也会很容易理解；
  2. Model类主要是完成原始数据到模型的映射，所以如何索引模型数据是关键，Qt中采用QModelIndex类来索引模型数据；
  3. QModelIndex类提供了行、列、父、子、兄弟的接口，以此实现对常见的矩阵结构和树结构原始数据的支持。

如有错误欢迎指正，共同进步~

今天你学废了吗？

QModelIndex 是 Qt 框架中的一个类，用于表示数据模型中的索引位置
m0_46376834的博客
12-17 2266
对象来表示数据模型中的单个元素，如表格中的单元格或树状结构中的节点等。它还可以用作从父级索引到子级索引的导航工具。是 Qt 中用于表示数据模型中索引位置的类，它提供了一种方便的方式来访问和操作数据模型中的元素。在 Qt 中，数据模型是一种组织和管理数据的方式，常见的数据模型包括。是 Qt 框架中的一个类，用于表示数据模型中的索引位置。方法检查索引对象是否有效，即是否在数据模型的范围内。创建新的索引对象，指定行号、列号和可选的父级索引。方法获取索引对象的行号和列号。方法获取索引对象的父级索引。
一文带你了解QT Model/View框架的设计思想和实现机制
dvlinker的技术专栏
11-18 9945
详细讲述QT的Model/View框架的设计思想和实现机制。
Model/View框架
aming090的博客
10-29 3767
一、Model/View框架简介 1、Model/View框架核心思想     Model/View框架的核心思想是模型（数据）与视图（显示）相分离，模型对外提供标准接口存取数据，不关心数据如何显示，视图自定义数据的显示方式，不关心数据如何组织存储。     Model/View框架中数据与显示的分离，可以允许使用不同界面显示同一数据，也能够在不改变数据的情况下添加新的显示界面。为了处理用户...
「QT」QT模型视图委托篇 之 QModelIndex 定位器
最新发布
何曾参静谧的博客
03-29 760
QModelIndex是Qt模型/视图架构中的核心类之一，它作为模型数据的定位器，在模型、视图和委托之间起着桥梁作用。理解QModelIndex对于掌握Qt模型视图编程至关重要。if (!// 根据数据结构创建适当的索引rootNode;// 将自定义数据结构指针与索引关联// 访问自定义数据成员QModelIndex是Qt模型/视图架构的基石，它提供了访问模型数据的统一方式。深入理解QModelIndex的工作机制对于开发复杂的模型视图应用至关重要。
模型索引QModelIndex
lusic01的专栏
05-30 1225
QModelIndex可以用来引用模型中的项，它包含确定这个项在模型中的位置所需的所有信息。索引拥有行信息、列信息，并且可能拥有父索引，可以使用row()、column()和parent()函数来获取这些信息。模型中的每个顶级项都由一个没有父索引的模型索引表示，在这种情况下，parent()将返回一个无效的模型索引，这种情况相当于使用QModelIndex()来构造无效索引。
Qt中由表中单元格的QModelIndex获取Global Pos的正确方法
weixin_34128534的博客
08-08 386
      一直在尝试从单元格的行列索引（QModelIndex）获取其单元格的全局坐标（Global Pos）的方法，以期待在指定单元格附近弹出帮助信息。由View中的columnViewportPosition()和rowViewportPosition()能够把行列值转换为坐标值，但继续用View的mapToGlobal映射坐标到全局坐标却出现位置偏差。太诡异了，后来经过摸索发现，colum...
模型索引：QModelIndex
zxf347085420的博客
01-14 1949
在真正的MVC中，Data的实体是对用户隐藏的，用户只能通过Model来读写Data中的内容，也即只有模型才知道如何获取数据View是不知道，参见我的本系列前面的博文，这样的好处是用户不必关心Data在系统底层的组织方式。从名字可以看出，他是模型的索引，只要对模型实体（各种xxxModel的实体）施加这个索引，model就会返回数据集中对应的值，或者通过这个索引修改对应数据集中的值。上述代码中，只要看懂了如何访问根节点的儿子A的儿子B，也即如何访问根节点的孙子B，那就算掌握了QModelIndex的精髓。
QT模型索引使用QModelIndex
Txwtech笛克特科
10-03 3638
QT模型索引使用QModelIndex。
QT学习笔记-Qt Model/View
kouqi627的博客
03-09 6047
目录前言一、Qt模型视图结构简介二、Qt模型概念Model indexes行列父项**数据项角色**三、Qt视图概念使用已有视图使用模型操作被选项四、Qt委托使用已有委托一个简单的自定义委托五、创建模型设计模型 前言 因工作需要，要实现一个小型的数据管理系统。本着想捡起来QT技能的想法，学习下QT模型视图的操作。 一、Qt模型视图结构简介 模型/视图结构，仍然分离了数据与呈现给用户的方式，但提供了基于相同原理的简单框架。这种分离使得它可以在几个不同的视图中显示相同的数据，并且实现新类型的视图，而无需改变
Qt Model/View之代理
qq_32640443的博客
09-14 1162
并利用这些函数的默认实现。委托编辑器可以。
Qt Model/View 实现Model类参考工程
12-24
它将数据模型（Model）与视图（View）和控制器（Controller）分离，使得数据的管理与界面显示相独立，提高了代码的可复用性和可维护性。本项目是一个基于Qt的Model/View实现，主要涉及的文件有`main.cpp`、`...
Qt 模型视图编程之 QModelIndex
编程猿来如此
12-05 1239
Qt 模型视图编程之 QModelIndex
QT模型视图MVC系列教程（2）-模型数据索引QModelIndex详解
野生猿-群号1025127672
02-01 9870
从名字可以看出，他是模型的索引，只要对模型实体（各种xxxModel的实体）施加这个索引，model就会返回数据集中对应的值，或者通过这个索引修改对应数据集中的值。 类比数组就更好理解了，charbuf[8] = {'a', 'b','c','d','e'}; 给定索引3，我们就能从数据集合中读出该值为'c'，或者任意修改数据集中的第3个值的值。 、 ...
QModelIndex
热门推荐
zhouzhouasishuijiao的博客
11-22 2万+
QModelIndex类用于定位数据模型中的数据。 Header: #include  "QModelIndex" qmake: QT+=core 此类用作从QAbstractItemModel派生的项模型的索引。 项目视图，代理和选择模型使用索引来定位模型中的项目。 新的QModelIndex对象是用QAbstractItemModel::createIndex()来生成，一个无效的索引...
【Qt之模型视图】2. 模型类及QModelIndex模型索引、自定义模型
FreeLikeTheWind的博客
01-17 3737
当需要为一个数据结构创建一个新的模型时，当然要考虑使用哪种模型为数据提供接口。如果数据结构为列表或表格，可以子类化和。因为这俩个抽象类提供了不错的默认实现。如果数据结构表现为树结构，就需要子类化以下是子类化的示例，包括编辑、插入、删除功能。首先实现显示只读功能.hQ_OBJECTpublic:private:.cppm_sl = sl;if(!
QModelIndex怎么用
Finull1的博客
05-12 2万+
QModelIndex有三个要素：行row 列column 父节点索引parent 但是注意我们并不能定义一个QModelIndex QModelIndex的构造函数QModelIndex()的功能是创建一个新的空的QModelIndex QModelIdex()是一个空索引，它其实可以代表任意model中的顶层节点，例如TableModel中每个Item的父节点都是顶层节点，所以每个Item的索引中的parent都是QModelIndex;【1】 可以获得QModelIndex 的方法有两种： 1.通过M
Qt入门教程【高级控件篇】QModelIndex索引
小鱼酱的博客
05-31 3960
QModelIndex索引
Qt当中model/view
03-08
### Qt Model/View 架构概述 Qt 的 Model/View 架构是一种设计模式，旨在分离数据处理逻辑（Model）、数据显示方式（View）以及两者之间的交互控制。这种架构不仅提高了代码的可维护性和重用性，还简化了复杂界面的设计[^1]。 #### Model-View 基础组件 - **Model**: 负责管理应用程序的数据及其内部状态。为了使不同类型的视图能够一致地访问这些信息，所有的模型都实现了 `QAbstractItemModel` 接口所规定的公共接口。对于简单的只读场景，可以创建继承自 `QAbstractTableModel` 或者 `QStandardItemModel` 的子类来实现特定功能[^4]。 - **View**: 显示来自关联模型的信息给用户看，并响应用户的输入事件。常见的视图控件有 `QTableView`, `QListView` 和 `QTreeView` 等。当需要展示表格化或者列表式的二维数组型数据时，推荐使用 `QTableView` 并结合自定义的模型类一起工作[^2]。 - **Delegate (代理)**: 定义了如何绘制单个项目并支持编辑操作。默认情况下，大多数内置视图都有自己的标准委托；然而，开发者也可以通过编写新的委托类来自定义外观和行为。 #### 关键类介绍 - **QModelIndex 类**：作为连接视图与模型之间通信的关键桥梁之一，提供了指向具体条目位置的方法。例如，可以通过指定行号、列号及父级索引来获取某个项目的引用，进而对其进行查询或修改操作[^3]： ```cpp // 获取数据 QModelIndex index = model->index(row, column, parentIndex); QVariant data = model->data(index); // 设置数据 model->setData(index, newValue); // 查找父项 QModelIndex parentIndex = index.parent(); ``` #### 创建自定义模型实例 假设要构建一个非常基本的只读表格式模型，则可以从 `QAbstractTableModel` 开始扩展，并重新实现必要的虚函数如 `rowCount()`, `columnCount()` 以及最重要的 `data()` 方法来返回实际存储的内容[^5]: ```cpp class MyModel : public QAbstractTableModel { public: int rowCount(const QModelIndex &parent = QModelIndex()) const override; int columnCount(const QModelIndex &parent = QModelIndex()) const override; QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; }; ``` 上述代码片段展示了怎样声明一个新的模型类，并指定了三个核心成员函数——它们分别决定了表格有多少行多少列，还有每个单元格里应该呈现什么文字内容。
评论 9
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值