QT的视图类（QTableView和QListView）（二）

QListView

开发工具：QT Creator

QListView 是 Qt 中用于显示列表数据的视图控件。它继承自 QAbstractItemView，通常与模型（如 QStringListModel、QStandardItemModel 或自定义模型）配合使用，用于呈现数据项的列表。

1、QListView和QStringListModel配合使用

// 创建数据list
QStringList list = {"item1", "item2", "item3"};

// 创建model, 并绑定list数据
QStringListModel *model = new QStringListModel(list);

// 给listView设置model
ui->listView->setModel(model);

创建的model也要注意声明周期，见QT的视图类（QTableView和QListView）（一）-优快云博客

QListView的QStringListModel增删数据其实就是对QStringList进行操作。

// 添加数据

// 通过model获取原有的数据list
QStringList updatelist = model->stringList();

// 往原有的数据list中添加数据
updatelist << "item4" << "item5";

// 给model设置更新后的list
model->setStringList(updatelist);

// 更新listView
ui->listView->update();


// 通过model获取原有的数据list
QStringList updatelist2 = model->stringList();

// 删除数据
updatelist2.takeFirst();

// 给model设置更新后的list
model->setStringList(updatelist2);

// 更新listView
ui->listView->update();

如果需要获取点击的是哪一个数据，可以使用点击事件

void onSelectionChanged(const QItemSelection &selected, const QItemSelection &deselected

void onSelectionChanged(const QItemSelection &selected, const QItemSelection &deselected) {
        QModelIndexList indexes = selected.indexes();
        if (!indexes.isEmpty()) {
            QModelIndex index = indexes.first();
            qDebug() << "Selected item:" << index.data().toString();
        }
    }

2、QListView和QStandardItemModel配合使用

使用步骤和QStringListModel一样，简单的使用方式不做多余的介绍了。

QStandardItemModel *model = new QStandardItemModel();
model->setColumnCount(3);
model->setHorizontalHeaderLabels({"Name", "Age", "City"});

QStandardItem *item1 = new QStandardItem("Alice");
QStandardItem *item2 = new QStandardItem("25");
QStandardItem *item3 = new QStandardItem("New York");
model->appendRow({item1, item2, item3});

// 创建 QTableView 来显示模型
QTableView *view = new QTableView();
view->setModel(model);

很多时候列表数据需要的不仅仅数数据，也可能需要按钮、图片、点击等功能，下面提供一个添加了按钮以及按钮事件的例子。

// listviewshow.h

#ifndef LISTVIEWSHOW_H
#define LISTVIEWSHOW_H

#include <QWidget>
#include <QListView>
#include <QStringListModel>

namespace Ui {
class listviewshow;
}

class listviewshow : public QWidget
{
    Q_OBJECT

public:
    explicit listviewshow(QWidget *parent = nullptr);
    ~listviewshow();

    void init();

public slots:
    void onButtonClicked(int);

private:
    Ui::listviewshow *ui;
    QListView *p_listview;
};

#endif // LISTVIEWSHOW_H

// listviewshow.cpp

#include "listviewshow.h"
#include "ui_listviewshow.h"
#include <QVBoxLayout>
#include <QStandardItemModel>
#include <QSignalMapper>

listviewshow::listviewshow(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::listviewshow),
    p_listview(nullptr)
{
    ui->setupUi(this);
    init();
}

listviewshow::~listviewshow()
{
    delete ui;
}

void listviewshow::init()
{
    // 创建 QListView 和模型
    QStandardItemModel *model = new QStandardItemModel(this);

    // 添加多个项到模型
    for (int i = 0; i < 4; ++i)
    {
        QStandardItem *item = new QStandardItem();
        item->setSizeHint(QSize(10, 50));
        model->appendRow(item);
    }

    ui->listView->setModel(model);


    // 创建信号映射器
    QSignalMapper *signalMapper = new QSignalMapper(this);

    // 为每个项设置自定义 QWidget
    for (int row = 0; row < model->rowCount(); ++row)
    {
        QWidget *widget = new QWidget();
        //widget->setMinimumHeight(25);
        QHBoxLayout *layout = new QHBoxLayout(widget);

        QLabel *label = new QLabel("Item " + QString::number(row + 1), widget);
        QPushButton *button = new QPushButton("Button", widget);

        // 将按钮与信号映射器绑定
        signalMapper->setMapping(button, row);  // 映射索引到按钮
        connect(button, &QPushButton::clicked, signalMapper, QOverload<>::of(&QSignalMapper::map));

        layout->addWidget(label);
        layout->addWidget(button);
        widget->setLayout(layout);

        ui->listView->setIndexWidget(model->index(row, 0), widget);
    }
    // 连接信号映射器的信号到槽
    connect(signalMapper, SIGNAL(mapped(int)), this, SLOT(onButtonClicked(int)));
}

void listviewshow::onButtonClicked(int row)
{
    qDebug() << "Button clicked for item row: " << row;
    //确认是哪一个按钮后，就能通过按钮的序号到list中去拿对应的数据
    //ui->listView->model()->index(row, 0);
    QWidget *targetWidget = ui->listView->indexWidget(ui->listView->model()->index(row, 0));
    QLabel *label = targetWidget->findChild<QLabel *>();
    qDebug() << "Found QLabel:" << label->text();
}