【Qt6】列表模型——便捷类型
前一篇水文中，老周演示了 QAbstractItemModel 抽象类的继承方法。其实，在 Qt 的库里面，QAbstractItemModel 类也派生了两个基类，能让开发者继承起来【稍稍】轻松一些。这两个类是 QAbstractListModel 和 QAbstractTableModel。
[*]QAbstractListModel类专门用来实现一维列表结构模型的。它实现了 index、parent 等方法，并且把 columnCount 方法变成了私有成员（一维列表不需要它）。继承时直接实现 rowCount、data、setData 这几个方法即可；
[*]QAbstractTableModel类专门用来实现二维表结构的模型。它实现了 index、parent 等方法。继承时咱们要实现 rowCount、columnCount、data、setData 等方法。
虽然它帮咱们实现了一些成员，但实际上也省不了多功夫的。下面咱们用 QAbstractListModel 举例，和上篇中的一样，操作一个 QList 数据。毕竟一维的比较简单，演示出来大伙都容易懂。
// 头文件
#ifndef LIST_H
#define LIST_H
#include <QAbstractListModel>
#include <QList>
class CustListModel: public QAbstractListModel
{
Q_OBJECT
public:
explicit CustListModel(QObject* parent = nullptr);
~CustListModel();
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);
bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex()) override;
bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex()) override;
Qt::ItemFlags flags(const QModelIndex &index) const override;
private:
// 私有，存数据用
QList<int> m_list;
};
#endif先弄 rowCount 方法，返回总行数，这个简单一点。
int CustListModel::rowCount(const QModelIndex &parent) const
{
if(parent.isValid())
{
return 0;
}
return m_list.size();
}实现 data 方法，获取数据时用。
QVariant CustListModel::data(const QModelIndex &index, int role) const
{
if( role == Qt::DisplayRole || role == Qt::EditRole)
{
if(!index.isValid())
{
return QVariant();
}
// 获取索引
int i = index.row();
// 返回指定索引处的值
return m_list.at(i);
}
return QVariant();
}要返回 QList 中指定的元素，用 at 方法，传递索引给它即可。
实现 setData 方法，编辑结束后用于更新数据的。
bool CustListModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
if(!index.isValid())
return false;
if(role == Qt::EditRole || role == Qt::DisplayRole)
{
// 解包数据
bool ok;
int val = value.toInt(&ok);
if(ok)
{
// 设置值
m_list.replace(index.row(), val);<br> // 发出信号
emit dataChanged(index,index,{role});
return true;
}
}
return false;
}要修改某个索引处的值，用 replace 方法替换。
实现 flags 方法，表明该模型的列表项支持交互、编辑、被选择。
Qt::ItemFlags CustListModel::flags(const QModelIndex &index) const
{
return Qt::ItemIsEnabled | Qt::ItemIsEditable | Qt::ItemIsSelectable;
}ItemIsEnabled 表明列表项是活动的，用户可操作的；ItemIsEditable 表明列表项可编辑；ItemIsSelectable 表示列表项可以选择。
下面这两个方法是有点麻烦的，这里先介绍一下。
bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex());row 参数表示要插入元素的索引，count 表示插入元素个数，插入元素后，原来的元素向后移动。例如：A、B、C、D，现在我要在B处插入两个元素。那么 row = 1，count = 2，B 处放入 E、F，B、C、D 向后移，变成 A、E、F、B、C、D。
然后，删除元素的方法也类似。
bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex());row 是要删除的索引，count 是连续要删掉的元素个数。
insertRows 和 removeRows 方法的返回值含义相同：成功返回 true，失败返回 false。
好，现在上代码。
bool CustListModel::insertRows(int row, int count, const QModelIndex &parent)
{
if(parent.isValid())
return false;
// 注意这里！！
beginInsertRows(parent, row, row + count - 1);
// 开始插入
m_list.insert(row, count, 0);
// 注意这里！！
endInsertRows();
return true;
}
bool CustListModel::removeRows(int row, int count, const QModelIndex &parent)
{
if(parent.isValid())
return false;
// 注意这里！！！
beginRemoveRows(parent, row, row + count - 1);
// 删除
m_list.remove(row, count);
// 注意这里！！！
endRemoveRows();
return true;
}在插入数据前必须调用 beginInsertRows 方法。注意这个方法的参数含义和 insertRows 有些不一样。
void beginInsertRows(const QModelIndex &parent, int first, int last)insertRows 方法是指定开始索引 ，然后连续加入多少个元素，而 beginInsertRows 方法是你插入元素后，它们在列表中的开始索引和结束索引。如 A、B、C，在B处插入两个元素。开始索引是 1，结束索引是 2，即结束索引的计算方法是： endIndex = startIndex + count -1。插入元素结束后必须调用 endInsertRows 方法。这一对方法的作用是让用户界面上的视图（如 QListView、QTableView 等）能及时做出响应。
同理，在删除元素时，beginRemoveRows 和 endRemoveRows 方法也必须调用。beginRemoveRows 方法的参数与 beginInsertRows 方法一样，也是索引的起止值。即要删除元素的起始索引，和被删除的最后一个元素的索引。如1、2、3、4，要删除2、3、4，那么起始索引是 1，结束索引 3。
模型已完工，下面做个界面试一试。
int main(int argc, char** argv)
{
QApplication myapp(argc, argv);
// 窗口
QWidget *window = new QWidget;
// 布局
QGridLayout *layout = new QGridLayout;
window->setLayout(layout);
// 列表视图
QListView* view = new QListView(window);
// 实例化模型
CustListModel* model = new CustListModel(window);
// 设置到视图中
view->setModel(model);
layout->addWidget(view, 0, 0, 3, 1);
// 按钮
QPushButton* btnAdd=new QPushButton("新增", window);
QPushButton* btnDel = new QPushButton("移除", window);
QPushButton* btnShowAll = new QPushButton("显示列表", window);
layout->addWidget(btnAdd, 0, 1);
layout->addWidget(btnDel, 1, 1);
layout->addWidget(btnShowAll, 2, 1);
layout->setColumnStretch(0, 1);
// 连接clicked信号
QObject::connect(
btnAdd,
&QPushButton::clicked,
[&view, &model, &window]()
{
bool res;
int val = QInputDialog::getInt(
window, //父窗口
"输入", //窗口标题
"请输入整数：", //提示文本
0, //默认值
0, //最小值
1000, //最大值
1, //步长值
&res //表示操作结果
);
if(!res)
return;
// 索引为count
int i = model->rowCount();
// 添加一项
model->insertRow(i);
// 获取新索引
QModelIndex newIndex = model->index(i);
// 设置此项的值
model->setData(newIndex, QVariant(val), Qt::DisplayRole);
}
);
QObject::connect(
btnDel,
&QPushButton::clicked,
[&window, &view, &model]()
{
// 当前项
QModelIndex curri = view->currentIndex();
if(!curri.isValid())
return;
// 删除
model->removeRow(curri.row());
}
);
QObject::connect(
btnShowAll,
&QPushButton::clicked,
[&model, &window]()
{
// 获取总数
int c = model->rowCount();
QString msg;
for(int x = 0; x < c; x++)
{
// 获取值
QVariant value = model->data(model->index(x), Qt::DisplayRole);
if(value.isValid())
{
int n = qvariant_cast<int>(value);
msg += QString(" %1").arg(n);
}
}
QMessageBox::information(window,"提示",msg);
}
);
// 标题
window->setWindowTitle("小型列表");
// 显示
window->show();
return QApplication::exec();
}QListView 组件用来显示模型中的数据。三个按钮分别用来添加、删除和显示列表项。最后一个按钮显示模型中的所有数据，它的作用是验证模型是否工作正常。
“新增”按钮被点击后，先通过 QInputDialog.getInt 静态方法，弹出一个输入内容的对话框，然后把输入的值添加到模型中。模型中添加元素用的就是 insertRow 方法——只插入一个元素，它调用了咱们上面实现的 insertRows 方法，只是把 count 参数设置为 1。这里我实现的是新元素总是追加在列表最后，即新元素的行号等于 rowCount。
删除元素时，QListView 组件的 currentIndex 方法返回当前选中项的索引。在单选模式下，99.9% 被选中的项是等同于当前项的。多选模式下就不好说了，所以，如果需要，可以访问 selectionModel 方法，再通过 selectedIndexes 方法获得被选项的列表。
看看效果。
https://img2023.cnblogs.com/blog/367389/202309/367389-20230917000113583-1708964766.gif
QAbstractTableModel 类的用法也是差不多的，只不过要实现行和列的读写。
这两个类哪怕帮咱们实现了一些代码，但用起来还是麻烦，要是有不需要继承、开箱就用的类就会好多了。Qt 还真的提供了这样的类型。
首先说的是 QStringListModel，这个就是针对 QStringList 类的——字符串列表。QStringList 其实就是 QList。这个 QStringListModel 模型就是以字符串列表为数据源的。不需要继承（除非你需要自定义），直接可用。
咱们演练一下。
// 头文件
#ifndef DEMO_H
#define DEMO_H
#include <QWidget>
#include <QPushButton>
#include <QListView>
#include <QVBoxLayout>
class MyWindow : public QWidget
{
Q_OBJECT
public:
explicit MyWindow(QWidget* parent = nullptr);
~MyWindow();
private:
QVBoxLayout* m_layout;
QPushButton* m_btn;
QListView* m_view;
// 用于连接clicked信号
void onClicked();
};
#endif三个组件：按钮被点击后加载数据；QListView 是视图组件，显示数据；QVBoxLayout 是布局用的，界面元素沿垂直方向排列（纵向）。公共成员就是构造函数和析构函数。析构是空白的，实现构造函数即可。
#include "../include/demo.h"
#include <QStringList>
#include <QStringListModel>
MyWindow::MyWindow(QWidget * parent)
: QWidget::QWidget(parent)
{
m_layout = new QVBoxLayout();
setLayout(m_layout);
// 按钮
m_btn = new QPushButton("加载数据", this);
m_layout->addWidget(m_btn);
// 视图
m_view = new QListView(this);
m_layout->addWidget(m_view, 1);
// 连接信号
connect(m_btn, &QPushButton::clicked, this, &MyWindow::onClicked);
}
MyWindow::~MyWindow()
{
}下面是重点，实现 onClicked 成员方法，构建数据并在视图中显示。
void MyWindow::onClicked()
{
// 创建字符串列表
QStringList list;
list << "手榴弹" << "地雷" << "鱼雷" << "燃烧弹";
// 创建模型实例
QStringListModel *model = new QStringListModel(list, this);
// 设置给视图
m_view->setModel(model);
}setRowCount、setColumnCount 方法可以不调用，模型会根据你放的数据调整。有两点得注意：
1、这里每个 QStandardItem 代表的是一个单元格的数据，而不是一行；
2、QStandardItem 类型的变量要声明为指针类型，并且要在堆上分配；不能用栈分配，会显示空白（提前析构了）。
然后，main 函数就更简单了。
int main(int argc, char** argv)
{
QApplication app(argc, argv);
MyWindow* win = new MyWindow();
win->setWindowTitle("示例");
win->resize(320, 275);
win->show();
return QApplication::exec();
}结果如下图：
https://img2023.cnblogs.com/blog/367389/202309/367389-20230917230420047-2552882.png
第一行和第四行，咱们修改过背景色和文本颜色。
QStandardItem();
explicit QStandardItem(const QString &text);
QStandardItem(const QIcon &icon, const QString &text);
explicit QStandardItem(int rows, int columns = 1);
好了，今天就聊到这儿，QStandardItemModel 还有其他耍法，尤其是在树形结构上。咱们下一期继续扯。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]