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();
}
觉得有帮助的话,打赏一下呗。。