【Qt之模型视图】2. 模型类及QModelIndex模型索引、自定义模型

1. 模型类

在模型/视图体系结构中,模型提供了一个标准接口,视图和委托使用该接口访问数据。在Qt中,标准接口是由QAbstractItemModel类定义的。无论数据项如何存储在任何底层数据结构中,QAbstractItemModel的所有子类都会以层次结构来表示数据,这个结构包含了数据项表。视图使用约定来访问模型中的数据项,但是它们向用户显示信息的方式不受限制,即视图可以使用任何方式显示数据。
常见的3中模型如下:
image.png
模型与视图交互通过信号和槽机制。

QAbstractItemModel类图如下:
image.png

2. 模型索引QModelIndex

为了确保数据的表示与访问数据的方式是分开的,引入了模型索引的概念。可以通过模型获得的每条信息都由模型索引表示。视图和委托使用这些索引请求要显示的数据项。
因此,只有模型需要知道如何获取数据,并且可以相当通用地定义模型管理的数据类型。模型索引包含一个指向创建它们的模型的指针,这可以防止在使用多个模型时出现混乱。
如:

  QAbstractItemModel *model = index.model();

模型索引提供对数据的临时引用,并可用于通过模型检索或修改数据。由于模型可能会不时地重新组织其内部结构,因此模型索引可能会失效,不应该存储。如果需要对某条信息进行长期引用,则必须创建持久模型索引。这提供了对模型保持最新的信息的引用。临时模型索引由QModelIndex类提供,持久模型索引由QPersistentModelIndex类提供。
要获得与数据项对应的模型索引,必须为模型指定三个属性:行号、列号和父项的模型索引。
如:

  QModelIndex index = model->index(row, column, parent);

2.1 行和列

一般来说,一个模型可以把它看做一个基本的表格来访问,这时呢,每个项可以通过行号和列号来定位。但这并不是说,底层数据是以某种固定数组结构存储,使用行号和列号进行访问只是一种方式,以确保各组件间可以香菇通信。
如:
image.png
行和列下标是从0开始的。
列表模型和表格模型,中的所有数据项都是以根项为父项的,所以这些数据项都可以被称为顶层数据项;在获取这些数据项的索引时,父项的索引可以用QModelIndex()表示。

  QModelIndex indexA = model->index(0, 0, QModelIndex());QModelIndex indexB = model->index(1, 1, QModelIndex());QModelIndex indexC = model->index(2, 1, QModelIndex());

2.2 父项

模型提供的类似表格的接口对于在表格或列表视图中使用数据非常理想;行和列号与视图显示项目的方式完全对应。
但是,像树视图这样的结构需要模型对项目内部公开一个更灵活的接口。因此,每个项目还可以是另一个项目表格的父项目,就像树视图中的顶级项目可以包含另一个项目列表一样。
当请求一个模型项目的索引时,必须提供一些关于项目父项的信息。在模型外部,唯一能引用项目的方式是通过模型索引,因此还必须给出一个父模型索引。

  QModelIndex index = model->index(row, column, parent);

如:
image.png

  QModelIndex indexA = model->index(0, 0, QModelIndex());QModelIndex indexC = model->index(2, 1, QModelIndex());QModelIndex indexB = model->index(1, 0, indexA);

2.4 ItemRole项角色

常量描述
Qt::DisplayRole0以文本形式呈现的关键数据。(QString类型)
Qt::DecorationRole1将以图标形式呈现为装饰的数据。(QColor、QIcon或QPixmap类型)
Qt::EditRole2适合在编辑器中编辑的表单中的数据。(QString类型)
Qt::ToolTipRole3项目工具提示中显示的数据。(QString类型)
Qt::StatusTipRole4状态栏中显示的数据。(QString类型)
Qt::WhatsThisRole5在“这是什么?”模式下显示的项目数据。(QString类型)
Qt::SizeHintRole13将提供给视图的项的大小提示。(QSize类型)

除此之外,还有其他itemRole:
如:

  • Qt::FontRole
  • Qt::TextAlignmentRole
  • Qt::BackgroundRole
  • Qt::BackgroundColorRole
  • Qt::ForegroundRole
  • Qt::TextColorRole
  • Qt::CheckStateRole
  • Qt::InitialSortOrderRole

等。

例如,Qt::DisplayRole 用于访问一个可以在视图中以文本形式显示的字符串。
通常,数据项包含多个不同角色的数据,标准角色由 Qt::ItemDataRole 定义。
因此可以通过传递与数据项对应的模型索引,并指定所需数据的角色,来向模型请求项目的数据:

  QVariant value = model->data(index, role);

大多数常见的数据项用法都被定义在 Qt::ItemDataRole 中的标准角色中。通过为每个角色提供适当的数据项,模型可以向视图和委托提供关于如何展示项目给用户的提示。不同类型的视图可以根据需要解析或忽略这些信息。还可以定义其他角色以用于特定于应用程序的目的。

    QListView* pLV = new QListView();QStringListModel* pModel = new QStringListModel(pLV);pLV->setModel(pModel);QStringList list;list << "a" << "b" << "c";pModel->setData(pModel->index(0, 0), "hello", Qt::EditRole);qDebug().noquote() <<  pModel->index(0, 0).data(Qt::DisplayRole).toString(); // "hello"

2.5 示例

// 创建视图QTreeView* pTW = new QTreeView();// 创建模型QStandardItemModel* pModel = new QStandardItemModel(pTW);pTW->setModel(pModel);// 获取根项,根项是不可见的QStandardItem* pRootItem = pModel->invisibleRootItem();// 创建item0,并设置相关信息QStandardItem* pItem0 = new QStandardItem();pItem0->setText("text : hello");pItem0->setToolTip("tooltip : say hello");QPixmap pixmap(100, 60);pixmap.fill(Qt::blue);pItem0->setIcon(QIcon(pixmap));pRootItem->appendRow(pItem0);// 创建item1,并以item0为父项QStandardItem* pItem1 = new QStandardItem();pItem1->setText("text : world");pItem1->setToolTip("tooltip : say world");pixmap.fill(Qt::green);pItem1->setIcon(QIcon(pixmap));pItem0->appendRow(pItem1);// 创建item2,并以setData方式,根据角色值进行设置及显示数据QStandardItem* pItem2 = new QStandardItem();pixmap.fill(Qt::darkCyan);pItem2->setData("text : china", Qt::DisplayRole);pItem2->setData(QIcon(pixmap), Qt::DecorationRole);pItem2->setData("tooltip : say china", Qt::ToolTipRole);pItem1->appendRow(pItem2);setCentralWidget(pTW);pTW->expandAll();// 输出0,0QModelIndex rootIndex = pModel->index(0, 0, QModelIndex());qDebug().noquote() << "0,0 : " << pModel->index(0, 0, QModelIndex()).data().toString();qDebug().noquote() << "rowCount : " << pModel->rowCount();qDebug().noquote() << "rootIndex 0,0 : " << pModel->index(0, 0, rootIndex).data().toString();qDebug().noquote() << "rootIndex 0,0 ToolTip : " << pModel->data(pModel->index(0, 0, rootIndex), Qt::ToolTipRole).toString();

image.png
image.png
QStandardItemModel标准项模型提供了一个通用的模型来存储自定义的数据。
其内部的项由QStandartItem类提供,该类提供了很多方法;此外,还可以使用setData()方法指定ItemRole设置数据。
当使用模型索引获取模型中的数据项时,需要指定行、列和父项,当获取顶层项目时,父项可以用QModelIndex()表示。
如果一个数据项含有不同的角色值,获取时需要指定相应的角色值。

3. 自定义模型

当需要为一个数据结构创建一个新的模型时,当然要考虑使用哪种模型为数据提供接口。
如果数据结构为列表或表格,可以子类化QAbstractListModelQAbstractTableModel。因为这俩个抽象类提供了不错的默认实现。
如果数据结构表现为树结构,就需要子类化QAbstractItemModel.

以下是子类化QAbstractListModel的示例,包括编辑、插入、删除功能。
首先实现显示只读功能
需要实现以下函数:

    virtual int rowCount(const QModelIndex &parent = QModelIndex()) const;virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;

如果是表格,想显示表头,还需要实现以下函数:

    virtual QVariant headerData(int section, Qt::Orientation orientation,int role = Qt::DisplayRole) const;

具体实现如下:
.h

#ifndef LISTMODELSUB_H
#define LISTMODELSUB_H#include <QAbstractListModel>
#include <QStringList>class C_ListModelSub : public QAbstractListModel
{Q_OBJECT
public:explicit C_ListModelSub(const QStringList& sl, QObject *parent = nullptr);virtual int rowCount(const QModelIndex &parent = QModelIndex()) const;virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;virtual QVariant headerData(int section, Qt::Orientation orientation,int role = Qt::DisplayRole) const;private:QStringList       m_sl;
};#endif // LISTMODELSUB_H

.cpp

#include "ListModelSub.h"C_ListModelSub::C_ListModelSub(const QStringList &sl, QObject *parent) : QAbstractListModel(parent)
{m_sl = sl;
}int C_ListModelSub::rowCount(const QModelIndex &parent) const
{return m_sl.size();
}QVariant C_ListModelSub::data(const QModelIndex &index, int role) const
{if(!index.isValid()){return QVariant();}if(index.row() == m_sl.size()){return QVariant();}if(role == Qt::DisplayRole){return m_sl.at(index.row());}else{return QVariant();}
}QVariant C_ListModelSub::headerData(int section, Qt::Orientation orientation, int role) const
{if(role != Qt::DisplayRole){return QVariant();}if(orientation == Qt::Horizontal){return QString("Col %1").arg(section);}else{return QString("Row %1").arg(section);}
}

显示如下:
image.png
接下来添加编辑功能:
要先实现编辑,需要实现virtual bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole);Qt::ItemFlags flags(const QModelIndex &index) const Q_DECL_OVERRIDE;函数。
flags()委托创建编辑器前会检测项是否是可编辑的,模型必须得让委托知道项是可编辑的,因此返回一个标签来达到这个目的。
setData()为委托向模型设置数据提供了一个途径。
具体实现如下:

// .hvirtual bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole);Qt::ItemFlags flags(const QModelIndex &index) const Q_DECL_OVERRIDE;// .cpp
bool C_ListModelSub::setData(const QModelIndex &index, const QVariant &value, int role)
{if(!index.isValid()){return QVariant();}if(Qt::EditRole == role || Qt::DisplayRole == role){m_sl.replace(index.row(), value.toString());// 数据设置过后,发送信号emit dataChanged(index, index);return true;}return false;
}Qt::ItemFlags C_ListModelSub::flags(const QModelIndex &index) const
{if(!index.isValid()){return Qt::ItemIsEnabled;}return QAbstractItemModel::flags(index) | Qt::ItemIsEditable;
}

image.png

再接下来就是删除和添加功能:
按照以上的思路,需要实现以下函数:

// .hvirtual bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex());virtual bool insertColumns(int column, int count, const QModelIndex &parent = QModelIndex());virtual bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex());virtual bool removeColumns(int column, int count, const QModelIndex &parent = QModelIndex());// .cpp
bool C_ListModelSub::insertRows(int row, int count, const QModelIndex &parent)
{beginInsertRows(QModelIndex(), row, row+count-1);for(int i = 0; i < count; ++i){m_sl.insert(row, "helloworld");}endInsertRows();return true;
}bool C_ListModelSub::insertColumns(int column, int count, const QModelIndex &parent)
{beginInsertColumns(QModelIndex(), column, column+count-1);for(int i = 0; i < count; ++i){m_sl.insert(column, "helloworld");}endInsertColumns();return true;
}bool C_ListModelSub::removeRows(int row, int count, const QModelIndex &parent)
{beginRemoveRows(QModelIndex(), row, row+count-1);for(int i = 0; i < count; ++i){m_sl.removeAt(row);}endRemoveRows();return true;
}bool C_ListModelSub::removeColumns(int column, int count, const QModelIndex &parent)
{beginRemoveColumns(QModelIndex(), column, column+count-1);for(int i = 0; i < count; ++i){m_sl.removeAt(column);}endRemoveColumns();return true;
}

beginInsertRows()开始行插入操作。在子类中重新实现insertRows()时,必须在将数据插入模型的底层数据存储之前调用该函数。
endRemoveRows()完成后调用该函数。

结果如下:
image.png
image.png

4. 结论

经过以上,可以看到,模型类各种操作是对具体的数据的操作,为外部调用提供统一接口。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/411967.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Express安装与基础使用

一、express 介绍 express 是一个基于 Node.js 平台的极简、灵活的 WEB 应用开发框架&#xff0c; 官方网站&#xff1a; Express - 基于 Node.js 平台的 web 应用开发框架 - Express中文文档 | Express中文网 中文文档&#xff1a; 路由 - Express 中文文档 简单来说&am…

探寻编码时代的潮流旋律

&#x1f6a9;本文介绍 随着技术的不断演进&#xff0c;编程语言作为软件开发的基石也在不断发展。作为一名扎根运维领域的工程师&#xff0c;我深感了解和把握编程语言的新趋势对于个人职业发展至关重要。在这篇博客中&#xff0c;我们将深入探讨当前编程语言领域的最新动态&…

K8S对外服务ingress

Sevice作用体现在两个方面 集群内部 不断跟踪pod的变化&#xff0c;更新endpoint中的pod对象&#xff0c;基于pod的ip地址不断发现的一种服务发现机制 集群外部 类似负载均衡器&#xff0c;把流量&#xff08;ip端口&#xff09;&#xff0c;不涉及转发url&#xff08;http ht…

C#,入门教程(38)——大型工程软件中类(class)修饰词partial的使用方法

上一篇&#xff1a; C#&#xff0c;入门教程(37)——优秀程序员的修炼之道https://blog.csdn.net/beijinghorn/article/details/125011644 一、大型&#xff08;工程应用&#xff09;软件倚重 partial 先说说大型&#xff08;工程应用&#xff09;软件对源代码的文件及函数“…

Luckysheet类似excel的在线表格(vue)

参考文档&#xff1a;快速上手 | Luckysheet文档 一、引入 在vue项目的public文件夹下的index.html的<head>标签里面引入 <link relstylesheet hrefhttps://cdn.jsdelivr.net/npm/luckysheetlatest/dist/plugins/css/pluginsCss.css /><link relstylesheet hre…

【汇编】 13.3 对int iret和栈的深入理解

书中示例 assume cs:codecode segment start:mov ax,csmov ds,axmov si,offset lpmov ax,0mov es,axmov di,200hmov cx,offset end0-offset lpcldrep movsb ;lp到end0的指令传送到0:200处mov ax,0mov es,axmov word ptr es:[7ch*4],200hmov word ptr es:[7ch*42],0 ;设置7c表项…

模拟实现简单的shell

目录 1.实现交互界面 2.子串分割的问题&#xff0c;解决命令行 3.指令的判断 1.实现交互界面 我们模仿打印出来就好了&#xff1a; 现在已经有初步的形状了。 2.子串分割的问题&#xff0c;解决命令行 3.指令的判断 看上面有一行内建命令中的export&#xff0c;其实不对的&a…

Redis在Windows10中安装和配置

1.首先去下载Redis 这里不给出下载地址&#xff0c;自己可以用去搜索一下地址 下载 下载完成后解压到D盘redis下&#xff0c;本人用的是3.2.100 D:\Redis\Redis-x64-3.2.100 2.解压完成后需要设置环境变量&#xff0c;这里新建一个系统环境变量中path 中添加一个文件所…

C++ 之LeetCode刷题记录(十二)

&#x1f604;&#x1f60a;&#x1f606;&#x1f603;&#x1f604;&#x1f60a;&#x1f606;&#x1f603; 开始cpp刷题之旅。 依旧是追求耗时0s的一天。 69. x 的平方根 示例 1&#xff1a; 输入&#xff1a;x 4 输出&#xff1a;2 示例 2&#xff1a; 输入&#x…

jenkins-cl参数化构建

pipeline片段&#xff08;对应jenkins-cli -p参数的BRANCHdevelop&#xff09; parameters {string(name: BRANCH, defaultValue: master, description: Enter the branch name)}stages {stage(Get Code) {steps {script {def branch params.BRANCHcheckout scmGit(branches: …

HFSS笔记/信号完整性分析(二)——软件仿真设置大全

文章目录 1、多核运算设置1.1 如何设置1.2 如何查看自己电脑的core呢&#xff1f;1.3 查看求解的频点 2、求解模式设置Driven Terminal vs Driven modal 3、Design settings4、自适应网格划分5、更改字体设置 仅做笔记整理与分享。 1、多核运算设置 多核运算只对扫频才有效果&…

Python中使用HTTP代理进行网络请求

在Python中&#xff0c;HTTP代理是一种常用的技术&#xff0c;用于控制和修改HTTP请求和响应。通过使用HTTP代理&#xff0c;我们可以更好地控制网络请求的行为&#xff0c;提高安全性、隐私性和效率。下面我们将详细介绍如何在Python中使用HTTP代理进行网络请求。 一、HTTP代…