QListWidget开发详解-CSDN博客

本文链接：https://blog.csdn.net/arv002/article/details/140507139

QListWidget开发详解

一、QListWidget基本使用
二、QListWidget响应用户交互
三、QListWidget和QTableWidget区别

QListWidget 是 Qt 提供的一个用于显示和管理列表项的控件。它是 QListView 的子类，并且集成了 QListView 和 QStandardItemModel 的功能，使得使用起来更加方便。以下是 QListWidget 开发的详细介绍，包括基本使用方法、添加和删除项、响应用户交互等。

一、QListWidget基本使用

1.1 创建 `QListWidget`

QListWidget *listWidget = new QListWidget(this);

1.2 QListWidget添加项

有多种方式可以向 QListWidget 添加项：

添加单个项：

listWidget->addItem("Item 1");
listWidget->addItem("Item 2");

添加多个项：

QStringList items;
items << "Item 3" << "Item 4" << "Item 5";
listWidget->addItems(items);

使用 QListWidgetItem 添加项：

QListWidgetItem *item = new QListWidgetItem("Item 6");
listWidget->addItem(item);

1.3 QListWidget删除项

删除单个项：

delete listWidget->takeItem(listWidget->row(item)); // 删除指定项

删除当前选中的项：

delete listWidget->takeItem(listWidget->currentRow());

1.4 QListWidget获取和设置项

获取当前选中的项：

QListWidgetItem *currentItem = listWidget->currentItem();
if (currentItem) {
    qDebug() << "Current item:" << currentItem->text();
}

设置项的文本：

QListWidgetItem *item = listWidget->item(0); // 获取第一个项
if (item) {
    item->setText("New Text");
}

二、QListWidget响应用户交互

2.1 QListWidget的单击响应

在 QListWidget 中实现单击响应，可以使用 itemClicked 信号。这个信号会在用户单击列表项时发射，并传递被单击的 QListWidgetItem 对象。通过连接该信号到槽函数，就可以在单击时执行相应的操作。

下面是一个示例，展示如何在 QListWidget 中实现单击响应，并显示被单击的项的文本：

#include <QListWidget>
#include <QVBoxLayout>
#include <QMessageBox>
#include <QWidget>
#include <QApplication>

class MainWindow : public QWidget
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr) : QWidget(parent)
    {
        // 创建 QListWidget 并添加一些项
        QListWidget *listWidget = new QListWidget(this);
        listWidget->addItem("Item 1");
        listWidget->addItem("Item 2");
        listWidget->addItem("Item 3");

        // 将 itemClicked 信号连接到自定义槽函数
        connect(listWidget, &QListWidget::itemClicked, this, &MainWindow::onItemClicked);

        // 布局设置
        QVBoxLayout *layout = new QVBoxLayout(this);
        layout->addWidget(listWidget);
        setLayout(layout);
    }

private slots:
    // 自定义槽函数，处理单击事件
    void onItemClicked(QListWidgetItem *item)
    {
        QMessageBox::information(this, "Item Clicked", "You clicked: " + item->text());
    }
};

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    MainWindow window;
    window.show();
    return app.exec();
}

#include "main.moc"

详细说明

创建 QListWidget 并添加项：

QListWidget *listWidget = new QListWidget(this);
listWidget->addItem("Item 1");
listWidget->addItem("Item 2");
listWidget->addItem("Item 3");

连接 itemClicked 信号到槽函数：

connect(listWidget, &QListWidget::itemClicked, this, &MainWindow::onItemClicked);

定义槽函数：

void onItemClicked(QListWidgetItem *item)
{
    QMessageBox::information(this, "Item Clicked", "You clicked: " + item->text());
}

显示窗口：

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    MainWindow window;
    window.show();
    return app.exec();
}

2.3 QListWidget的 currentItemChanged

2.3 QListWidget的右键餐单

要在 QListWidget 上实现右键菜单操作，可以通过以下步骤完成：

创建右键菜单： 在需要右键菜单的地方创建一个 QMenu 对象，并添加菜单项。
连接信号与槽： 将 QListWidget 的 customContextMenuRequested 信号连接到一个槽函数，该函数在用户请求自定义上下文菜单时触发。
显示菜单： 在槽函数中根据需要显示右键菜单。

下面是一个简单的示例，演示如何实现这些步骤：

#include <QtWidgets>

class MyListWidget : public QListWidget {
public:
    MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {
        // 添加一些项作为示例
        addItem("Item 1");
        addItem("Item 2");
        addItem("Item 3");

        // 连接右键菜单请求信号
        connect(this, &QListWidget::customContextMenuRequested, this, &MyListWidget::showContextMenu);
    }

private:
    void showContextMenu(const QPoint &pos) {
        QMenu contextMenu(tr("Context menu"), this);

        QAction *action1 = new QAction("Action 1", this);
        connect(action1, &QAction::triggered, this, &MyListWidget::action1Clicked);
        contextMenu.addAction(action1);

        QAction *action2 = new QAction("Action 2", this);
        connect(action2, &QAction::triggered, this, &MyListWidget::action2Clicked);
        contextMenu.addAction(action2);

        contextMenu.exec(mapToGlobal(pos));
    }

    void action1Clicked() {
        qDebug() << "Action 1 clicked!";
    }

    void action2Clicked() {
        qDebug() << "Action 2 clicked!";
    }
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    MyListWidget listWidget;
    listWidget.show();

    return app.exec();
}

在这个示例中，我们创建了一个自定义的 MyListWidget 类，继承自 QListWidget。在构造函数中，我们添加了几个项作为示例，并连接了 customContextMenuRequested 信号到 showContextMenu 槽函数。在 showContextMenu 函数中，我们创建了一个 QMenu 对象，并添加了两个动作 Action 1 和 Action 2，并分别连接到 action1Clicked 和 action2Clicked 槽函数。

当用户在 QListWidget 上右键单击时，会触发 customContextMenuRequested 信号，从而显示我们创建的右键菜单。

三、QListWidget和QTableWidget区别

QListWidget 和 QTableWidget 是 Qt 中用于显示和管理数据的两种不同类型的控件。它们的主要区别在于数据的组织和显示方式。

3.1 QListWidget

QListWidget 是一个单列的列表控件，适用于显示简单的列表数据。每个列表项是一个 QListWidgetItem 对象，可以包含文本、图标等。以下是 QListWidget 的一些特点：

单列显示：QListWidget 只能显示一列数据，每个项是一个独立的对象。
简单数据展示：适用于展示简单的、独立的列表项，例如任务列表、联系人列表等。
操作简便：提供了方便的接口用于添加、删除、修改和获取列表项。

使用示例：

#include <QListWidget>
#include <QVBoxLayout>
#include <QWidget>

QListWidget *listWidget = new QListWidget(this);
listWidget->addItem("Item 1");
listWidget->addItem("Item 2");
listWidget->addItem("Item 3");

QVBoxLayout *layout = new QVBoxLayout(this);
layout->addWidget(listWidget);
setLayout(layout);

3.2 QTableWidget

QTableWidget 是一个表格控件，适用于显示多行多列的数据。每个单元格是一个 QTableWidgetItem 对象，可以包含文本、图标等。以下是 QTableWidget 的一些特点：

多行多列显示：QTableWidget 可以显示多行多列的数据，类似于电子表格。
复杂数据展示：适用于展示结构化的、多维度的数据，例如财务报表、商品清单等。
灵活操作：提供了丰富的接口用于添加、删除、修改和获取单元格数据，还可以设置单元格的样式和属性。

使用示例：

#include <QTableWidget>
#include <QVBoxLayout>
#include <QWidget>

QTableWidget *tableWidget = new QTableWidget(3, 2, this);
tableWidget->setHorizontalHeaderLabels(QStringList() << "Column 1" << "Column 2");

tableWidget->setItem(0, 0, new QTableWidgetItem("Item 1-1"));
tableWidget->setItem(0, 1, new QTableWidgetItem("Item 1-2"));
tableWidget->setItem(1, 0, new QTableWidgetItem("Item 2-1"));
tableWidget->setItem(1, 1, new QTableWidgetItem("Item 2-2"));

QVBoxLayout *layout = new QVBoxLayout(this);
layout->addWidget(tableWidget);
setLayout(layout);

3.3 对比总结

数据组织方式：
- QListWidget：单列数据，每个项是独立的。
- QTableWidget：多行多列数据，每个单元格都是独立的，可以有行和列的交互。
适用场景：
- QListWidget：适用于简单的列表数据，例如文件列表、任务列表。
- QTableWidget：适用于复杂的表格数据，例如财务报表、学生成绩表。
操作复杂度：
- QListWidget：操作简单，接口直接，适合快速开发和简单数据展示。
- QTableWidget：操作相对复杂，提供了更丰富的接口和更大的灵活性。