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

最新推荐文章于 2024-04-29 21:03:23 发布
最新推荐文章于 2024-04-29 21:03:23 发布
阅读量1.1k 收藏 21
点赞数 22
分类专栏： Qt视图模型 文章标签： qt microsoft 数据库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/mrhhhhhh/article/details/135661032
版权

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,0
    QModelIndex 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. 自定义模型

当需要为一个数据结构创建一个新的模型时，当然要考虑使用哪种模型为数据提供接口。
如果数据结构为列表或表格，可以子类化QAbstractListModel和QAbstractTableModel。因为这俩个抽象类提供了不错的默认实现。
如果数据结构表现为树结构，就需要子类化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()为委托向模型设置数据提供了一个途径。
具体实现如下：

// .h
    virtual 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

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

// .h
    virtual 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. 结论

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

FreeLikeTheWind.
关注
  • 22
    点赞
  • 踩
  • 21
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
QT：控件精讲（二）单元视图Item Views
通哈膨胀哈哈哈 的博客
12-11 5334
    Qt Creator有4种Item Views。如图     View Widget的Qt类和名称介绍如下表：     控件类     控件名     中文名     QListView     ListView     列表视图     QTreeView     TreeView     树形视图     QTableView     TableView     表格     ...
QModelIndex 是 Qt 框架中的一个类，用于表示数据模型中的索引位置
m0_46376834的博客
12-17 728
对象来表示数据模型中的单个元素，如表格中的单元格或树状结构中的节点等。它还可以用作从父级索引到子级索引的导航工具。是 Qt 中用于表示数据模型中索引位置的类，它提供了一种方便的方式来访问和操作数据模型中的元素。在 Qt 中，数据模型是一种组织和管理数据的方式，常见的数据模型包括。是 Qt 框架中的一个类，用于表示数据模型中的索引位置。方法检查索引对象是否有效，即是否在数据模型的范围内。创建新的索引对象，指定行号、列号和可选的父级索引。方法获取索引对象的行号和列号。方法获取索引对象的父级索引。
qt 获取table中的值
wyyy2088511的博客
01-09 715
QAbstractItemModel *model = myTable->getTableview()->model(); QModelIndex index1 = model->index(index.row(),0); QVariant data1 = model->data(index1); QString idStr =data1.toString(); qDebug()<<"index.row():"&l...
QModelIndex 与QStandardItem相互转换
cangqiongxiaoye的博客
10-31 352
QModelIndex 与QStandardItem相互转换
QTableView的indexAt使用方法
weixin_30888413的博客
10-13 1650
要实现的功能是QTableview中Item项上右键弹出菜单这就必然要判断点击右键时鼠标指针是否在QTableView的Item上如果是QTableWidget可以用itemAt来判断QTableView通过查看文档发现有个indexAt函数返回QModelIndex QModelIndex QTableView::indexAt(const QPoint & pos)...
python3+PyQt5自定义视图详解
01-20
pyqt提供的几个视图类都可以较好工作，包括QLisView，QTableView和QTreeView。但是对于一些难以用现有的方式来呈现数据，这时，可以创建我们自己的视图子类并将其用做模型数据的可视化来解决这一问题。本文通过...
python3+PyQt5使用数据库表视图
12-25
上文提到窗体可以一次性呈现出来自同一记录的各个域，但是对于用户希望能看到多条记录的表来说，就需要使用表格化的视图了。本文通过python3+pyqt5改写实现了python Qt gui 快速变成15章的例子，用户能够一次看到多...
App015.zip
02-14
Qt的C++QTableModel实现起来有点乱，尤其QModelIndex、rolenames不知所云（估计是索引、数据访问方面的考虑），但要与qml混用就很麻烦。我自行实现QAbstractListModel，既可以用作ListModel，又可以用作TableModel，...
untitled6.rar
04-16
使用QT通过c++语言，重写了QTableViewModel类的data(const QModelIndex &index, int role) const函数，实现了单行单元格设置颜色
QTreeView详解
03-21
QTreeView详解
模型视图(10)：【类】QModelIndex[官翻]
读书笔记
12-28 2657
文章目录详述公共函数相关的非成员类参见 QModelIndex 类 QModelIndex类用于定位数据模型中的数据。 Header: #include < QModelIndex > qmake: QT += core Inherits: Inherited By: 详述 该类用作从QAbstractItemModel派生的项模型的索引。项视图、委托和选择模型使用索引来定位模型中的项。 新的QModelIndex对象由模型使用QAbstractItemMod
Qt入门教程【高级控件篇】QModelIndex索引
小鱼酱的博客
05-31 3487
QModelIndex索引
QStandardItemModel角色控制及QTreeView加入不同的右键菜单
weixin_33810006的博客
10-08 185
1.概述 QTreeView最长用的一个功能就是作为导航栏，像vs里的项目结构树，word的文档结构图，资源管理器的文档结构，等等都是利用树形结构组织的，在前面已经讲述了Qt中使用标准化项目模型QStandardItemModel对树形控件节点的操作。但有时候，光有节点显示还是不够的，还须要和用户进行交互，如右键点击不同条目会出现不同菜单，这时就须要知道各个节点相应的功能。 在...
QModelIndex的使用
热门推荐
wwpp的博客
01-08 4万+
最近使用QTreeView，一开始对于很多函数中针对item的唯一标识QModelIndex的使用是无从下手，记录下两种对于QModelIdex的使用 1，树形结构的item设置为选中 QModelIndex rootIndex; QModelIndex robotsIndex; QModelIndex nonMobileIndex; rootIndex = treeView->mode
Qt Model/View 学习(2) - QModelIndex索引模型数据
Copperxcx的博客
12-23 4706
了解Model的核心类以及QModelIndex索引~
QT模型视图MVC系列教程（2）-模型数据索引QModelIndex详解
野生猿-群号1025127672
02-01 8808
从名字可以看出，他是模型的索引，只要对模型实体（各种xxxModel的实体）施加这个索引，model就会返回数据集中对应的值，或者通过这个索引修改对应数据集中的值。 类比数组就更好理解了，charbuf[8] = {'a', 'b','c','d','e'}; 给定索引3，我们就能从数据集合中读出该值为'c'，或者任意修改数据集中的第3个值的值。 、 ...
Qt QLineEdit详解
最新发布
希望能帮助大家，希望大家多多支持，你们的支持是我前进的动力。
04-29 540
QLineEdit是一个单行文本编辑器。行编辑允许用户使用一组有用的编辑功能输入和编辑单行纯文本，包括撤消和重做、剪切和粘贴以及拖放。通过更改行编辑的echoMode，它也可以用作“只写”字段，用于密码等输入。文本的长度可以限制为maxLength，文本可以使用validator或inputMask进行任意约束，也可以同时使用这两种方法。在同一行编辑的validator和inputMask之间切换时，最好清除validator或输入mask，以防止出现未定义的行为。
Qt模型视图移动项的位置
07-12
在Qt中，可以使用模型视图框架来管理和显示数据。要移动模型视图中的项的位置，可以使用以下方法： 1. 使用QModelIndex类来表示项的位置。QModelIndex包含了项的行和列信息，可以通过模型的索引方法获取。 2. 使用QAbstractItemModel类来管理模型数据。这是一个抽象基类，可以根据需要派生实现自定义的模型类。 3. 使用QTreeView、QTableView或QListView等视图类来显示模型数据。这些类提供了用户界面，可以显示和编辑模型数据。 要移动项的位置，可以按照以下步骤进行操作： 1. 获取要移动的项的源索引，可以使用模型的index()方法获取。 2. 获取目标位置的索引，可以使用模型的index()方法获取。 3. 使用模型的beginMoveRows()方法通知视图开始移动项的位置。该方法接受源索引的父索引、源索引的起始行和结束行、目标位置的父索引以及目标位置的行。 4. 使用模型的moveRow()方法实际移动项的位置。该方法接受源索引的父索引、源索引的行、目标位置的父索引以及目标位置的行。 5. 使用模型的endMoveRows()方法通知视图完成移动项的位置。 下面是一个示例代码，演示如何移动模型视图中的项的位置： ```cpp QModelIndex sourceIndex = model->index(sourceRow, 0, sourceParent); QModelIndex targetIndex = model->index(targetRow, 0, targetParent); model->beginMoveRows(sourceParent, sourceRow, sourceRow, targetParent, targetRow); model->moveRow(sourceParent, sourceRow, targetParent, targetRow); model->endMoveRows(); ``` 请注意，上述代码中的model是一个QAbstractItemModel类的实例，sourceRow和targetRow分别是源索引和目标索引的行，sourceParent和targetParent分别是源索引和目标索引的父索引。 希望这能帮助到你！如果你有任何其他问题，请随时提问。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

FreeLikeTheWind.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值