QListView开发入门

1. QListView 基础介绍

QListView 是 Qt 框架中用于显示项目列表的控件，属于模型/视图架构的一部分。它提供了一种灵活的方式来显示和操作项目列表。

主要特点：

  • 基于模型/视图架构

  • 支持多种视图模式（列表、图标）

  • 内置选择、编辑功能

  • 可自定义项目显示方式

2. 基本使用

2.1 简单示例

#include <QApplication>
#include <QListView>
#include <QStringListModel>int main(int argc, char *argv[]) {QApplication app(argc, argv);// 创建数据模型QStringList strings;strings << "苹果" << "香蕉" << "橙子" << "西瓜";QStringListModel model(strings);// 创建并设置ListViewQListView listView;listView.setModel(&model);listView.setWindowTitle("水果列表");listView.resize(300, 200);listView.show();return app.exec();
}

2.2 常用方法

// 设置选择模式
listView.setSelectionMode(QAbstractItemView::SingleSelection);  // 单选
listView.setSelectionMode(QAbstractItemView::MultiSelection);   // 多选// 设置视图模式
listView.setViewMode(QListView::ListMode);    // 列表模式（默认）
listView.setViewMode(QListView::IconMode);    // 图标模式// 设置是否可编辑
listView.setEditTriggers(QAbstractItemView::NoEditTriggers);    // 不可编辑
listView.setEditTriggers(QAbstractItemView::DoubleClicked);     // 双击编辑// 设置网格线
listView.setGridSize(QSize(100, 30));         // 设置项目大小
listView.setSpacing(5);                       // 设置项目间距

 

3. 数据模型使用

3.1 使用 QStringListModel

QStringListModel *model = new QStringListModel(this);
QStringList list;
list << "项目1" << "项目2" << "项目3";
model->setStringList(list);ui->listView->setModel(model);

3.2 使用 QStandardItemModel

QStandardItemModel *model = new QStandardItemModel(this);// 添加文本项目
QStandardItem *item1 = new QStandardItem("文本项目");
model->appendRow(item1);// 添加带图标的项目
QStandardItem *item2 = new QStandardItem(QIcon(":/icon.png"), "带图标项目");
model->appendRow(item2);// 添加可勾选项目
QStandardItem *item3 = new QStandardItem("可勾选项目");
item3->setCheckable(true);
item3->setCheckState(Qt::Checked);
model->appendRow(item3);ui->listView->setModel(model);

 

4. 项目选择与操作

4.1 获取选中项目

// 获取当前选中项的索引
QModelIndex currentIndex = ui->listView->currentIndex();// 获取所有选中项的索引列表
QModelIndexList selectedIndexes = ui->listView->selectionModel()->selectedIndexes();// 通过模型获取数据
QVariant data = model->data(currentIndex, Qt::DisplayRole);

4.2 添加和删除项目

// 添加项目
void addItem(const QString &text) {QStandardItemModel *model = qobject_cast<QStandardItemModel*>(ui->listView->model());if(model) {model->appendRow(new QStandardItem(text));}
}// 删除选中项目
void removeSelectedItems() {QStandardItemModel *model = qobject_cast<QStandardItemModel*>(ui->listView->model());if(!model) return;QModelIndexList selected = ui->listView->selectionModel()->selectedIndexes();foreach(QModelIndex index, selected) {model->removeRow(index.row());}
}

5. 自定义显示

5.1 使用委托（Delegate）自定义项目显示

class CustomDelegate : public QStyledItemDelegate {
public:using QStyledItemDelegate::QStyledItemDelegate;void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {if (option.state & QStyle::State_Selected) {painter->fillRect(option.rect, QColor("#4CAF50"));  // 选中项背景色}QStyledItemDelegate::paint(painter, option, index);}QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override {// 设置项目高度QSize size = QStyledItemDelegate::sizeHint(option, index);size.setHeight(40);return size;}
};// 使用自定义委托
ui->listView->setItemDelegate(new CustomDelegate(this));

 5.2 设置交替行颜色

ui->listView->setAlternatingRowColors(true);
ui->listView->setStyleSheet("alternate-background-color: #f0f0f0;");

6. 自定义模型

在 Qt 中创建自定义模型需要继承自 QAbstractItemModel 或其子类（如 QAbstractListModel）。对于列表视图，通常继承 QAbstractListModel 更为简单。

1）.基本模型结构

#include <QAbstractListModel>
#include <QStringList>class CustomListModel : public QAbstractListModel {Q_OBJECTpublic:explicit CustomListModel(QObject *parent = nullptr);// 必须重写的基类方法int rowCount(const QModelIndex &parent = QModelIndex()) const override;QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;// 可选重写的方法QVariant headerData(int section, Qt::Orientation orientation, int role) const override;Qt::ItemFlags flags(const QModelIndex &index) const override;// 自定义数据操作方法void addItem(const QString &item);void removeItem(int row);private:QStringList m_data; // 实际存储数据的容器
};

2）. 实现自定义模型

2.1 基本实现
CustomListModel::CustomListModel(QObject *parent) : QAbstractListModel(parent) {}int CustomListModel::rowCount(const QModelIndex &parent) const {// 对于列表模型，parent无效时应返回项目数if (parent.isValid())return 0;return m_data.size();
}QVariant CustomListModel::data(const QModelIndex &index, int role) const {if (!index.isValid() || index.row() >= m_data.size())return QVariant();switch (role) {case Qt::DisplayRole:case Qt::EditRole:return m_data.at(index.row());case Qt::ToolTipRole:return QString("项目: %1").arg(m_data.at(index.row()));case Qt::TextAlignmentRole:return Qt::AlignVCenter | Qt::AlignLeft;default:return QVariant();}
}Qt::ItemFlags CustomListModel::flags(const QModelIndex &index) const {if (!index.isValid())return Qt::NoItemFlags;return QAbstractListModel::flags(index) | Qt::ItemIsEditable | Qt::ItemIsSelectable;
}
2.2 数据操作方法
void CustomListModel::addItem(const QString &item) {beginInsertRows(QModelIndex(), m_data.size(), m_data.size());m_data.append(item);endInsertRows();
}void CustomListModel::removeItem(int row) {if (row < 0 || row >= m_data.size())return;beginRemoveRows(QModelIndex(), row, row);m_data.removeAt(row);endRemoveRows();
}bool CustomListModel::setData(const QModelIndex &index, const QVariant &value, int role) {if (!index.isValid() || role != Qt::EditRole)return false;m_data.replace(index.row(), value.toString());emit dataChanged(index, index, {role});return true;
}

3）. 高级自定义功能

3.1 支持拖放操作
// 在构造函数中添加
setSupportedDragActions(Qt::MoveAction);
setSupportedDropActions(Qt::MoveAction);Qt::DropActions CustomListModel::supportedDropActions() const {return Qt::MoveAction;
}QStringList CustomListModel::mimeTypes() const {return {"application/vnd.text.list"};
}QMimeData *CustomListModel::mimeData(const QModelIndexList &indexes) const {auto *mimeData = new QMimeData;QByteArray encodedData;QDataStream stream(&encodedData, QIODevice::WriteOnly);for (const QModelIndex &index : indexes) {if (index.isValid())stream << m_data.at(index.row());}mimeData->setData("application/vnd.text.list", encodedData);return mimeData;
}bool CustomListModel::dropMimeData(const QMimeData *data, Qt::DropAction action,int row, int column, const QModelIndex &parent) {if (!data->hasFormat("application/vnd.text.list"))return false;QByteArray encodedData = data->data("application/vnd.text.list");QDataStream stream(&encodedData, QIODevice::ReadOnly);QStringList newItems;while (!stream.atEnd()) {QString text;stream >> text;newItems << text;}// 插入新项目int beginRow = row != -1 ? row : rowCount(parent);for (const QString &text : qAsConst(newItems)) {insertRow(beginRow);setData(index(beginRow, 0, parent), text);beginRow++;}return true;
}
3.2 自定义角色
// 在头文件中定义自定义角色
enum CustomRoles {BackgroundColorRole = Qt::UserRole + 1,TextColorRole,IconRole
};// 在data()方法中添加处理
QVariant CustomListModel::data(const QModelIndex &index, int role) const {// ... 其他代码switch (role) {case BackgroundColorRole:return index.row() % 2 == 0 ? QColor("#f0f0f0") : QColor("#ffffff");case TextColorRole:return QColor("#333333");case IconRole:return QIcon(":/icons/item.png");// ... 其他角色}
}

4）. 使用自定义模型 

4.1 基本使用
CustomListModel *model = new CustomListModel(this);
model->addItem("项目1");
model->addItem("项目2");
model->addItem("项目3");QListView *listView = new QListView;
listView->setModel(model);// 启用拖放
listView->setDragEnabled(true);
listView->setAcceptDrops(true);
listView->setDropIndicatorShown(true);
listView->setDragDropMode(QAbstractItemView::InternalMove);
4.2 使用自定义角色
// 使用委托显示自定义角色
class CustomDelegate : public QStyledItemDelegate {
public:using QStyledItemDelegate::QStyledItemDelegate;void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {QStyleOptionViewItem opt = option;initStyleOption(&opt, index);// 获取自定义角色数据QColor bgColor = index.data(BackgroundColorRole).value<QColor>();QColor textColor = index.data(TextColorRole).value<QColor>();QIcon icon = index.data(IconRole).value<QIcon>();// 自定义绘制painter->fillRect(opt.rect, bgColor);QRect iconRect = opt.rect.adjusted(5, 5, -5, -5);iconRect.setWidth(32);icon.paint(painter, iconRect);QRect textRect = opt.rect.adjusted(42, 0, -5, 0);painter->setPen(textColor);painter->drawText(textRect, Qt::AlignVCenter | Qt::AlignLeft, opt.text);}QSize sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const override {return QSize(200, 40);}
};// 设置自定义委托
listView->setItemDelegate(new CustomDelegate);

5）. 性能优化技巧

1）实现 canFetchMore/fetchMore 用于大数据集的懒加载：

bool canFetchMore(const QModelIndex &parent) const override {return !m_allDataLoaded && m_data.size() < m_totalItems;
}void fetchMore(const QModelIndex &parent) override {int remaining = m_totalItems - m_data.size();int itemsToFetch = qMin(100, remaining);if (itemsToFetch <= 0) {m_allDataLoaded = true;return;}beginInsertRows(QModelIndex(), m_data.size(), m_data.size() + itemsToFetch - 1);// 加载更多数据...endInsertRows();
}

2）优化 data() 方法：避免在 data() 中进行复杂计算
3）批量更新：使用 beginResetModel()/endResetModel() 进行大批量数据更新
4）使用模型测试：实现 QAbstractItemModelTester 检查模型一致性 

7. 信号与槽 

// 当前项变化信号
connect(ui->listView, &QListView::clicked, [](const QModelIndex &index){qDebug() << "点击了:" << index.data().toString();
});// 双击项目信号
connect(ui->listView, &QListView::doubleClicked, [](const QModelIndex &index){qDebug() << "双击了:" << index.data().toString();
});// 选择变化信号
connect(ui->listView->selectionModel(), &QItemSelectionModel::selectionChanged, [](const QItemSelection &selected, const QItemSelection &deselected){qDebug() << "选择已改变";});

8. 高级功能

7.1 拖放支持
// 启用拖放
ui->listView->setDragEnabled(true);          // 允许拖动
ui->listView->setAcceptDrops(true);          // 接受放置
ui->listView->setDropIndicatorShown(true);   // 显示放置指示器
ui->listView->setDragDropMode(QAbstractItemView::InternalMove);  // 内部移动// 自定义拖放行为需要重写模型的 mimeData() 和 dropMimeData() 方法
7.2 排序和过滤
// 启用排序
ui->listView->setSortingEnabled(true);// 使用代理模型进行过滤
QSortFilterProxyModel *proxyModel = new QSortFilterProxyModel(this);
proxyModel->setSourceModel(sourceModel);
proxyModel->setFilterRegExp(QRegExp("pattern", Qt::CaseInsensitive));
ui->listView->setModel(proxyModel);

9. 性能优化

  1. 大数据集处理：

    // 对于大数据集，禁用不必要的功能
ui->listView->setUniformItemSizes(true);  // 所有项目大小相同可提高性能
ui->listView->setViewMode(QListView::ListMode);  // 列表模式比图标模式性能更好

  2. 自定义模型：对于复杂数据，考虑实现自定义模型，只加载可见项数据

  3. 避免频繁更新：批量更新数据而不是逐项更新

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

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

相关文章

Cookie可以存哪些指？

Cookie可以存哪些指？

Cookie是一种小型文本文件&#xff0c;通常由服务器生成并发送到用户浏览器中保存。它可以用于存储一些简单但非常有用的信息&#xff0c;以便于后续请求时自动附带回服务器使用。下面是Cookie能够存储的一些典型内容类别及用途说明&#xff1a; 会话标识符(Session ID) 这是最…
阅读更多...
非手性分子发光有妙招：借液晶之力，实现高不对称圆偏振发光

非手性分子发光有妙招：借液晶之力，实现高不对称圆偏振发光

*本文只做阅读笔记分享* 一、圆偏振发光研究背景与挑战 圆偏振发光&#xff08;CPL&#xff09;材料在3D显示、光电器件等领域大有用处&#xff0c;衡量它的一个重要指标是不对称发光因子&#xff08;glum&#xff09;。早期CPL材料的glum值低&#xff0c;限制了实际应用。为…
阅读更多...
CSS中的em,rem,vm,vh详解

CSS中的em,rem,vm,vh详解

一&#xff1a;em 和 rem 是两种相对单位&#xff0c;它们常用于 CSS 中来设置尺寸、字体大小、间距等&#xff0c;主要用于更灵活和响应式的布局设计。它们与像素&#xff08;px&#xff09;不同&#xff0c;不是固定的&#xff0c;而是相对于其他元素的尺寸来计算的。 1. em …
阅读更多...
《非暴力沟通》第十二章 “重获生活的热情” 总结

《非暴力沟通》第十二章 “重获生活的热情” 总结

《非暴力沟通》第十二章 “重获生活的热情” 的核心总结&#xff1a; 本章将非暴力沟通的核心理念延伸至生命意义的探索&#xff0c;提出通过觉察与满足内心深处的需要&#xff0c;打破“义务性生存”的桎梏&#xff0c;让生活回归由衷的喜悦与创造。作者强调&#xff0c;当行动…
阅读更多...
MySQL数据库精研之旅第五期：CRUD的趣味探索(上)

MySQL数据库精研之旅第五期：CRUD的趣味探索(上)

专栏&#xff1a;MySQL数据库成长记 个人主页&#xff1a;手握风云 目录 一、CRUD简介 二、Create新增 2.1. 语法 2.2. 示例 三、Retrieve检索 3.1. 语法 3.2. 示例 一、CRUD简介 CURD是对数据库中的记录进行基本的增删改查操作&#xff1a;Create(创建)、Retrieve(检索…
阅读更多...
【银河麒麟系统常识】需求：安装.NET SDK

【银河麒麟系统常识】需求：安装.NET SDK

前提 网络状态正常(非离线安装)&#xff1b; 终端命令如下所示 根据不同系统的版本&#xff0c;自行选择&#xff0c;逐行执行即可&#xff1b; # 基于 Ubuntu/Debian 的银河麒麟系统 wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O…
阅读更多...
行业智能体大爆发，分布式智能云有解

行业智能体大爆发，分布式智能云有解

Manus的一夜爆红&#xff0c;在全球范围内引爆关于AI智能体的讨论。 与过去一般的AI助手不同&#xff0c;智能体&#xff08;AI Agent&#xff09;并非只是被动响应&#xff0c;而是主动感知、决策并执行的应用。Gartner预测&#xff0c;到2028年&#xff0c;15%的日常工作决策…
阅读更多...
工作记录 2017-03-13

工作记录 2017-03-13

工作记录 2017-03-13 序号 工作 相关人员 1 修改邮件上的问题。 开始处理操作日志部分。 测试了C#和MySql的连接。 更新RD服务器。 郝 更新的问题 1、 修改了CMS1500的打印&#xff0c;NDC的内容用了小的字体。 2、在Cliams List中可以查看Job的Notes。 3、Payment Po…
阅读更多...
【七层分析框架：寒门贵子消亡的系统性绞杀】

【七层分析框架：寒门贵子消亡的系统性绞杀】

七层分析框架&#xff1a;寒门贵子消亡的系统性绞杀 第一层&#xff1a;教育资源断层 结论&#xff1a;基础教育投入差已达量子级差距 机制&#xff1a; 北京海淀小学生均经费&#xff08;&#xffe5;47,800&#xff09; 云南山区&#xff08;&#xffe5;6,200&#xff09;…
阅读更多...
Codeforces Round 1014 (Div. 2)(A-D)

Codeforces Round 1014 (Div. 2)(A-D)

题目链接&#xff1a;Dashboard - Codeforces Round 1014 (Div. 2) - Codeforces A. Kamilka and the Sheep 思路 最大值-最小值 代码 void solve(){int n;cin>>n;vi a(n10);int mx0;int miinf;for(int i1;i<n;i){cin>>a[i];mimin(mi,a[i]);mxmax(mx,a[i])…
阅读更多...
开源AI智能体项目OpenManus的部署

开源AI智能体项目OpenManus的部署

关于开源AI智能体项目OpenManus的部署与背景信息整理如下&#xff1a; 1. OpenManus 背景与核心亮点 开发背景&#xff1a;Manus作为一款闭源的通用型AI智能体产品&#xff0c;因内测邀请码稀缺&#xff08;二手平台炒至10万元&#xff09;引发争议。开源社区迅速反应&#xff…
阅读更多...
使用jieba库进行TF-IDF关键词提取

使用jieba库进行TF-IDF关键词提取

文章目录 一、什么是TF-IDF&#xff1f;二、为什么选择jieba库&#xff1f;三、代码实现1.导入必要的库2. 读取文件3.将文件路径和内容存储到DataFrame4.加载自定义词典和停用词5.分词并去除停用词 四、总结 一、什么是TF-IDF&#xff1f; TF-IDF&#xff08;Term Frequency-I…
阅读更多...
【学Rust写CAD】20 平铺模式结构体(spread.rs)

【学Rust写CAD】20 平铺模式结构体(spread.rs)

这个 Spread。rs文件定义了渐变超出定义区域时的扩展方式&#xff0c;通常用于处理渐变在边界之外的行为。 源码 //color/spread.rs #[derive(Debug, Clone, Copy)] pub struct Pad; // 空结构体&#xff0c;表示 Pad 模式#[derive(Debug, Clone, Copy)] pub struct Reflect…
阅读更多...
[操作系统，学习记录]3.进程（2）

[操作系统，学习记录]3.进程（2）

1.fork(); 玩法一&#xff1a;通过返回值if&#xff0c;else去执行不同的代码片段 玩法二&#xff1a;if&#xff0c;else然后调用execve函数去执行新的程序 2.进程终止&#xff1a; 退出码&#xff0c;子进程通过exit/return返回&#xff0c;父进程wait/waitpid等待而得&am…
阅读更多...
Masked Attention 在 LLM 训练中的作用与原理

Masked Attention 在 LLM 训练中的作用与原理

在大语言模型&#xff08;LLM&#xff09;训练过程中&#xff0c;Masked Attention&#xff08;掩码注意力&#xff09; 是一个关键机制&#xff0c;它决定了 模型如何在训练时只利用过去的信息&#xff0c;而不会看到未来的 token。这篇文章将帮助你理解 Masked Attention 的作…
阅读更多...
【自学笔记】PHP语言基础知识点总览-持续更新

【自学笔记】PHP语言基础知识点总览-持续更新

提示&#xff1a;文章写完后&#xff0c;目录可以自动生成&#xff0c;如何生成可参考右边的帮助文档 文章目录 1. PHP 简介2. PHP 环境搭建3. 基本语法变量与常量数据类型运算符 4. 控制结构条件语句循环语句 5. 函数函数定义与调用作用域 6. 数组7. 字符串8. 表单处理9. 会话…
阅读更多...
css选择最后结尾的元素DOM

css选择最后结尾的元素DOM

前言 选中最后一个元素&#xff0c;实际使用非常频繁。 解决方案 使用 CSS 提供的选择器&#xff0c;即可完成。 如下代码示例&#xff0c;两种选择器均可实现。 <p>...</p>p:last-child{ background:#ff0000; }p:nth-last-child(1){background:#ff0000; }p&…
阅读更多...
Axios 相关的面试题

Axios 相关的面试题

在跟着视频教程学习项目的时候使用了axios发送请求&#xff0c;但是只是跟着把代码粘贴上去&#xff0c;一些语法规则根本不太清楚&#xff0c;但是根据之前的博客学习了fetch了之后&#xff0c;一看axios的介绍就明白了。所以就直接展示axios的面试题吧 本文主要内容&#xff…
阅读更多...
瑞芯微RKRGA（librga）Buffer API 分析

瑞芯微RKRGA（librga）Buffer API 分析

一、Buffer API 简介 在瑞芯微官方的 librga 库的手册中&#xff0c;有两组配置 buffer 的API&#xff1a; importbuffer 方式&#xff1a; importbuffer_virtualaddr importbuffer_physicaladdr importbuffer_fd wrapbuffer 方式&#xff1a; wrapbuffer_virtualaddr wrapb…
阅读更多...
C语言：多线程

C语言：多线程

多线程概述 定义 多线程是指在一个程序中可以同时运行多个不同的执行路径&#xff08;线程&#xff09;&#xff0c;这些线程可以并发或并行执行。并发是指多个线程在宏观上同时执行&#xff0c;但在微观上可能是交替执行的&#xff1b;并行则是指多个线程真正地同时执行&…
阅读更多...
最新文章

Copyright @ 2022~2023