1、概述
QListView 是 Qt 框架中的一个视图类，用于展示模型中的数据。它基于 QAbstractItemView，支持多种视图模式，如列表视图（List View）、图标视图（Icon View）等。QListView 是模型/视图框架的一部分，通常与 QStandardItemModel 或从 QAbstractItemModel 派生的自定义模型一起使用。在这种模型-视图架构中，数据存储在模型中，而视图负责呈现该数据。QListView 提供了灵活的显示模式和高度的自定义能力，使得开发者可以根据需要选择最适合的呈现方式。
2、重要方法
QListView 提供了多种方法来管理和展示数据，以下是一些重要的方法：
- setSelectionMode：设置选择模式，如单选（SingleSelection）、多选（MultiSelection）等。
- setEditTriggers：设置编辑触发器，决定何时可以编辑列表项。
- setFocusPolicy：设置焦点策略，决定视图是否可以接受焦点。
- setModel：设置数据模型，将数据模型与视图关联起来。
- viewMode 和 setViewMode：获取和设置视图模式，如列表模式（ListMode）和图标模式（IconMode）。
- setGridSize：在图标模式下设置网格大小。
此外，QListView 还支持通过委托（delegates）自定义视图中项的外观和交互方式，这通常通过重写 QStyledItemDelegate 类的相关方法来实现。
3、重要信号
QListView 发射多种信号来响应用户的操作，以下是一些重要的信号：
- clicked：单击某项时发射此信号。
- doubleClicked：双击某项时发射此信号。
- activated：当用户激活某个项目时发射此信号。
- entered：当鼠标光标进入某个项目时发射此信号。
- iconSizeChanged：在视图可见时设置图标大小时发射此信号。
- indexesMoved：在视图中移动索引时发射此信号。
- pressed：按下鼠标按钮时发射此信号。
- viewportEntered：当鼠标光标进入视图时发射此信号。
这些信号允许开发者在用户与 QListView 交互时执行特定的操作。
4、视图模式和布局方向
ViewMode
QListView::ViewMode 枚举定义了视图模式：
- QListView::ListMode:列表模式。
- QListView::IconMode:图标模式。
Flow
QListView::Flow枚举定义了项目布局方向：
- QListView::LeftToRight:从左到右布局。
- QListView::TopToBottom:从上到下布局。
#include <QApplication>
#include <QListView>
#include <QStandardItemModel>
#include <QDebug> int main(int argc, char *argv[]) { QApplication app(argc, argv); // 创建一个 QListView 实例 QListView listView; // 创建一个模型并添加一些数据 QStandardItemModel model; for (int i = 0; i < 10; ++i) { QStandardItem *item = new QStandardItem(QString("Item %1").arg(i)); item->setCheckable(true); // 显示复选框 item->setCheckState(Qt::Unchecked); // 设置复选框状态 model.appendRow(item); } // 将模型设置给 QListView listView.setModel(&model); // 设置选择模式为单选模式 listView.setSelectionMode(QAbstractItemView::SingleSelection); // 连接 clicked 信号到槽函数 QObject::connect(&listView, &QListView::clicked, [&](const QModelIndex &index) { QVariant value = model.data(index, Qt::DisplayRole); qDebug() << "Clicked item:" << value.toString(); }); // 显示 QListView listView.show(); return app.exec();
}
觉得有帮助的话，打赏一下呗。。
