Qt6开发跨平台音乐播放器（九）：QListWidget两种扩展方法

1. 概述

在展示小批量数据方面，QListWidget是一个非常实用的部件，但默认的QListWidget只能展示文本，功能比较局限。在很多情况下，我们需要在列表中使用其它控件来对数据进行操作，比如复选框和菜单等，这时就需要扩展QListWidget了，这一节我们来聊聊两种扩展QListWidget的方法：

• 使用delegate扩展

• 使用setItemWidget扩展

作为例子，我们使用两种方法各自实现一个带下拉菜单的QListWidget

2. delegate

delegate是用于自定义模型/视图架构（list/table/tree等）中数据项的呈现和编辑方式的工具，它具有以下作用：

• 自定义外观：可以完全控制数据项在视图中的外观，包括自定义字体、颜色、背景、图标等各种视觉元素

• 自定义编辑功能：允许创建自定义的编辑组件，以替代默认的编辑方式

• 优化交互

  • 可以响应各种用户交互事件，如鼠标点击、悬停、键盘输入等，并根据这些事件执行特定的操作。

  • 可以优化数据项的选择和导航行为。例如，可以实现特殊的选择效果，或者在特定情况下自动滚动视图以确保用户关注的数据项可见。

而delegate的使用有固定的步骤：

• 继承delegate基类：QListWidget通常使用QStyledItemDelegate或QItemDelegate

• 重写关键接口：比如paint接口用于绘制，editorEvent接口用于编辑响应

• 设置delegate：这一步比较简单，就是将delegate设置到视图，使其生效

基于以上信息，我们创建一个SongItemDelegate类，头文件如下：

// songitemdelegate.h
#pragma once

#include <QStyledItemDelegate>

class SongItemDelegate : public QStyledItemDelegate {
   
   
    Q_OBJECT

public:
    explicit SongItemDelegate(QObject *parent = nullptr) : QStyledItemDelegate(parent) {
   
   }
    virtual ~SongItemDelegate() {
   
   }

protected:
    void paint(QPainter *painter, const QStyleOptionViewItem &option,
                       const QModelIndex &index) const override;
    QSize sizeHint(const QStyleOptionViewItem &option,