QT M/V架构开发实战:QStringListModel介绍

### 目录

  • [@[TOC](目录)](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [前言](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [一、QStringListModel初步介绍](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [二、基本功能](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [1.创建](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [2.基本属性与方法](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [三、​何时使用 QStringListModel?​​](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)
  • [四、​何时避免使用 QStringListModel?​​](#目录 @TOC 前言 一、QStringListModel初步介绍 二、基本功能 1.创建 2.基本属性与方法 三、何时使用 QStringListModel? 四、何时避免使用 QStringListModel?)

前言


本文主要介绍的是使用代码生成的情况下对控件的介绍,包括拥有的功能及能修改的样式,也会说明在qtdesiner拖拽控件生成和使用代码生成控件的区别(如果有的话,遇到了的会说),此版本不属于最终版本,以后遇到什么新奇的点会继续更新!本文基于QT官方的文档进行的编写,QT版本为qt 5.14.0,编写环境为Windows11。不得不说官方文档真是个好东西,有时候有些不会的上去一看就能有灵感解决了,可惜没有中文版本的。

一、QStringListModel初步介绍

QStringListModel是一个专门为处理简单的字符串列表 (QStringList) 而设计的轻量级模型,是 QAbstractListModel的子类(因此它只支持单列数据)。它非常高效且易于使用,特别适合在列表视图 (QListView)、下拉框 (QComboBox) 或列表控件 (QListWidget内部使用模型时) 中显示一维的字符串数据。

核心思想 :​​

1、QStringListModel内部封装了一个 QStringList。

2、将 QStringList中的每个字符串映射为模型中的一行(索引为 row,列固定为 0)。

3、自动实现了 QAbstractListModel要求的核心接口 (rowCount, data, setData, flags, insertRows, removeRows等)。

二、基本功能

1.创建

cpp 复制代码
// 创建一个空模型
QStringListModel *model = new QStringListModel(parent);

// 创建时用字符串列表初始化
QStringList initialList;
initialList << "Apple" << "Banana" << "Orange";
QStringListModel *model = new QStringListModel(initialList, parent);

2.基本属性与方法

1)设置和获取字符串列表

cpp 复制代码
// 设置整个字符串列表 (会重置模型)
QStringList fruits;
fruits << "Apple" << "Banana" << "Cherry";
model->setStringList(fruits);

// 获取模型当前持有的整个字符串列表
QStringList currentList = model->stringList();

2)获取行数

cpp 复制代码
int count = model->rowCount(); // 等同于 model->stringList().size()

3)获取数据 (data())

cpp 复制代码
// 获取指定行 (row) 的字符串 (列固定为 0)
QModelIndex index = model->index(row, 0); // 创建行的索引
QString itemText = model->data(index, Qt::DisplayRole).toString(); // 获取显示文本
// 也可以直接获取 EditRole,对于字符串通常和 DisplayRole 一样
QString editText = model->data(index, Qt::EditRole).toString();

4)修改数据 (setData())

cpp 复制代码
QModelIndex index = model->index(row, 0);
bool success = model->setData(index, "New Fruit Name", Qt::EditRole);
// 如果成功,模型会:
//   1. 更新内部 QStringList 对应位置的字符串
//   2. 自动发射 dataChanged(index, index) 信号通知视图更新

5)​检查标志 (flags())

cpp 复制代码
// 默认 flags 包含 Qt::ItemIsEditable
Qt::ItemFlags f = model->flags(index);
if (f & Qt::ItemIsEditable) {
    qDebug() << "Item is editable";
}
// 如果你想禁用特定项的编辑(虽然不常见):
// 需要继承 QStringListModel 并重写 flags(index) 方法

6)​插入行 (insertRows())

cpp 复制代码
// 在 row 位置插入 count 行空字符串
model->insertRows(row, count);
// 或者插入后立即设置数据
model->insertRows(row, 1); // 插入一行
QModelIndex newIndex = model->index(row, 0);
model->setData(newIndex, "Inserted Fruit", Qt::EditRole);

7)删除行 (removeRows())

cpp 复制代码
// 删除从 row 开始的 count 行
model->removeRows(row, count);

8)​追加行

cpp 复制代码
int newRow = model->rowCount();
model->insertRows(newRow, 1); // 在末尾插入一行
model->setData(model->index(newRow, 0), "New Fruit", Qt::EditRole);
// 或者直接操作 stringList 再 set
QStringList list = model->stringList();
list.append("New Fruit");
model->setStringList(list); // 注意:这会重置模型,发出 modelReset 信号

9)​排序 (sort())

cpp 复制代码
// 升序排序 (默认)
model->sort(0); // 参数是列号,对于 QStringListModel 只能是 0

// 降序排序
model->sort(0, Qt::DescendingOrder);

// 自定义排序规则 (需要继承 QStringListModel 并重写 lessThan)
class MyStringListModel : public QStringListModel {
protected:
    bool lessThan(const QModelIndex &left, const QModelIndex &right) const override {
        QString leftStr = data(left, Qt::DisplayRole).toString();
        QString rightStr = data(right, Qt::DisplayRole).toString();
        // 例如:不区分大小写排序
        return leftStr.toLower() < rightStr.toLower();
        // 或者按字符串长度排序
        // return leftStr.length() < rightStr.length();
    }
};
// 然后使用你的自定义模型
MyStringListModel *customModel = new MyStringListModel;
customModel->setStringList(fruits);
customModel->sort(0); // 会使用你重写的 lessThan

10)​​与视图连接

cpp 复制代码
QListView *listView = new QListView;
listView->setModel(model); // 关键一步!

// 或者用于 QComboBox
QComboBox *comboBox = new QComboBox;
comboBox->setModel(model); // 下拉选项即为字符串列表

三、​何时使用 QStringListModel?​​

数据是简单的一维字符串列表。​​ 这是最重要的前提。

​​需要将字符串列表显示在 QListView, QComboBox或其他支持模型的列表控件中。​​

​​需要支持基本的操作:​​ 显示、编辑、排序、增删行。

​​追求效率和轻量:​​ 数据量可能较大,使用 QStandardItemModel为每个字符串创建 QStandardItem开销过大。

​​数据源本身就是一个 QStringList。​​

四、​何时避免使用 QStringListModel?​​

​数据不是简单的字符串列表:​​ 需要显示图标、颜色、字体等额外信息,或者数据是多列的(表格)。此时应使用 QStandardItemModel或自定义 QAbstractItemModel。

​​需要复杂的树状结构。​​ QStringListModel只支持扁平列表。

​​需要非常复杂的自定义行为:​​ 虽然可以通过继承重写,但如果需求复杂,可能直接继承 QAbstractListModel或 QAbstractItemModel更清晰。

本次分享就到这里了,如果有什么错误的话请指正,或者有什么疑问的,也可以在评论区一起探讨!

相关推荐
程序定小飞7 分钟前
基于springboot的民宿在线预定平台开发与设计
java·开发语言·spring boot·后端·spring
weixin_466812 分钟前
Redis数据库基础
数据库·redis·缓存
清风66666618 分钟前
基于单片机的档案库房漏水检测报警labview上位机系统设计
数据库·单片机·毕业设计·课程设计·labview·期末大作业
天天进步201531 分钟前
Python全栈项目--基于计算机视觉的车牌识别系统
开发语言·python·计算机视觉
DarkAthena42 分钟前
【GaussDB】在duckdb中查询GaussDB的数据
数据库·gaussdb·duckdb
苏琢玉1 小时前
收藏版:Phinx 数据库迁移完全指南
数据库·mysql·php
Algo-hx1 小时前
C++编程基础(五):字符数组和字符串
开发语言·c++
无敌最俊朗@1 小时前
C++ STL中 std::list 的高频面试题与答案
开发语言·c++·list
星光一影1 小时前
Java医院管理系统HIS源码带小程序和安装教程
java·开发语言·小程序
敲代码的瓦龙1 小时前
C语言?大小端!!!
c语言·开发语言·c++·1024程序员节