【QT学习十】QListView

一、QListView 概述

二、QListView 的主要特性包括：

三、基本用法

1、创建及基本属性设置

2、添加显示的值

3、获取ListView中的内容

4、列表模式和图标模式之间切换

5、自定义

四、提高性能

五、总结

一、QListView 概述

QListView 是一个用于显示列表数据的控件，它提供了灵活的视图模型以及对列表项的高度自定义的能力。

1、QListView 是Qt中的一个视图类，用于展示模型中的数据。它基于QAbstractItemView，支持多种视图模式，包括列表视图（List View）、图标视图（Icon View）、详细信息视图（Detail View）等。

2、QListView 类是Qt中模型/视图框架的一部分，通常与QStandardItemModel或从QAbstractItemModel派生的自定义模型一起使用。

`二、`QListView 的主要特性包括：

模型-视图架构： 遵循模型-视图架构，其中数据存储在模型中，而视图负责呈现该数据。
灵活的显示模式： QListView 支持不同的显示模式，包括列表视图（基于文本）和图标视图（基于图标），这种灵活性允许选择最适合的呈现方式。
自定义： 可以通过使用委托（delegates）自定义视图中项的外观，委托控制数据的渲染和编辑方式。
项目布局： 项目可以按照从上到下或者从左到右等方向进行布局，可以是固定的，也可以允许移动。视图的flow()和movement()属性控制这些行为。
选择处理： 提供了处理项目选择的机制，允许用户与显示的数据进行交互。

三、基本用法

1、创建及基本属性设置

    m_listView->setSelectionMode(QAbstractItemView::SingleSelection);m_listView->setEditTriggers(QAbstractItemView::NoEditTriggers);m_listView->setFocusPolicy(Qt::NoFocus);

这段代码设置了 QListView 的一些属性，定制了其行为：

setSelectionMode(QAbstractItemView::SingleSelection)：设置选择模式为单选模式，即只能选择一个项目。
setEditTriggers(QAbstractItemView::NoEditTriggers)：设置编辑触发器为不可编辑，禁止编辑项目。
setFocusPolicy(Qt::NoFocus)：设置焦点策略为 Qt::NoFocus，禁止该视图接受焦点。

2、添加显示的值

    // 创建QStandardItemModel作为数据模型QStandardItemModel *model = new QStandardItemModel(m_listView);// 向模型添加数据项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);}// 将模型设置给QListViewm_listView->setModel(model);

3、获取ListView中的内容

    QAbstractItemModel* model = m_listView->model();QModelIndexList indexes;for (int var = 0; var < model->rowCount(); ++var) {QModelIndex index = model->index(var,0);indexes.append(index);}for(const QModelIndex &index :indexes){QVariant value = model->data(index,Qt::CheckStateRole);if(value.isValid() && value.toInt() == Qt::Checked){QVariant val = model->data(index,Qt::DisplayRole);qDebug() << val.toString();}}

这段代码通过遍历 QListView 的模型中的所有行，获取每行第一列的索引，并检查该行是否处于选中状态（Qt::Checked）。如果是选中状态，就获取该行的显示数据并输出。

4、列表模式和图标模式之间切换

   // 创建一个按钮用于切换显示模式QPushButton *toggleButton = new QPushButton("Toggle View Mode");// 连接按钮点击事件，切换QListView的显示模式QObject::connect(toggleButton, &QPushButton::clicked, [&]() {if (m_listView->viewMode() == QListView::ListMode) {m_listView->setViewMode(QListView::IconMode);// 设置图标大小m_listView->setGridSize(QSize(50, 50));  } else {m_listView->setViewMode(QListView::ListMode);}});// 布局管理QBoxLayout *box = new QBoxLayout(QBoxLayout::TopToBottom);box->setContentsMargins(0,0,0,0);box->setSpacing(0);box->addWidget(toggleButton);box->addWidget(m_listView);

5、自定义

允许通过委托（delegates）自定义项目的外观和交互方式。

class CustomDelegate : public QStyledItemDelegate {
public:void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override {// 获取项目的文本内容QString text = index.data(Qt::DisplayRole).toString();// 设置不同的颜色和字体painter->save();if (index.row() % 2 == 0) {painter->setPen(Qt::blue);painter->setFont(QFont("Arial", 12, QFont::Bold));} else {painter->setPen(Qt::green);painter->setFont(QFont("Times", 14, QFont::Light));}// 绘制文本painter->drawText(option.rect, Qt::AlignCenter, text);painter->restore();}
};// 使用自定义委托CustomDelegate *customDelegate = new CustomDelegate;m_listView->setItemDelegate(customDelegate);

在这个例子中，我们创建了一个自定义的委托类 CustomDelegate 继承自 QStyledItemDelegate。在 paint 函数中，我们根据项目的行数（偶数或奇数）设置了不同的颜色和字体，然后使用 QPainter 绘制了文本。