QListView悬停高亮颜色未应用于项图标问题咨询

这个问题其实是Qt默认的项绘制逻辑导致的——QListView的样式表只会给item的背景区域上色，而图标本身作为独立的像素资源，默认不会在hover状态下自动应用颜色叠加，只有选中状态时Qt才会对图标做特殊处理。下面给你两种可行的解决方案：

方法一：自定义QStyledItemDelegate动态染色图标 #

这是最灵活的方案，通过重写项委托的绘制逻辑，在hover状态下给图标叠加高亮颜色，效果和选中时保持一致。

步骤1：创建自定义委托类 #

#include <QStyledItemDelegate>
#include <QPainter>
#include <QStyleOptionViewItem>

class HoverIconDelegate : public QStyledItemDelegate
{
    Q_OBJECT
public:
    explicit HoverIconDelegate(QObject *parent = nullptr) 
        : QStyledItemDelegate(parent) {}

    void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override
    {
        QStyleOptionViewItem opt = option;
        initStyleOption(&opt, index);

        // 先按照样式表绘制item的背景、边框和文本
        QStyledItemDelegate::paint(painter, opt, index);

        // 如果没有图标就直接返回
        if (opt.icon.isNull()) return;

        // 判断当前是否处于【悬停且未选中】的状态
        bool isHovered = (opt.state & QStyle::State_MouseOver) && !(opt.state & QStyle::State_Selected);
        if (isHovered) {
            // 获取与项尺寸匹配的图标像素图
            QPixmap originalPixmap = opt.icon.pixmap(opt.decorationSize);
            
            // 创建用于叠加颜色的像素图
            QPixmap hoverPixmap(originalPixmap.size());
            hoverPixmap.fill(Qt::transparent);
            
            QPainter pixmapPainter(&hoverPixmap);
            // 先绘制原始图标
            pixmapPainter.setCompositionMode(QPainter::CompositionMode_Source);
            pixmapPainter.drawPixmap(0, 0, originalPixmap);
            
            // 在图标不透明区域叠加高亮颜色（用你样式表中的hover背景色）
            pixmapPainter.setCompositionMode(QPainter::CompositionMode_SourceAtop);
            pixmapPainter.fillRect(hoverPixmap.rect(), QColor("#c6e5ff"));
            pixmapPainter.end();

            // 计算图标在项中的绘制位置，和默认逻辑保持一致
            QRect iconRect = opt.style->subElementRect(QStyle::SE_ItemViewItemDecoration, &opt);
            painter->drawPixmap(iconRect, hoverPixmap);
        }
    }
};

步骤2：给QListView设置自定义委托 #

在你的视图初始化代码中，添加这一行：

yourListView->setItemDelegate(new HoverIconDelegate(this));

这个方案的核心是利用QPainter的混合模式，让高亮颜色只覆盖图标中的不透明区域（也就是你的3D模型部分），完美复刻选中时的图标高亮效果。

方法二：提前准备hover状态的图标（备选方案） #

如果你不想自定义委托，可以提前渲染好带高亮效果的图标，然后在模型的data方法中根据项的状态返回对应图标。不过这种方法需要额外处理视图的状态通知，因为模型本身无法直接知道项是否处于hover状态：

• 提前为每个3D模型生成hover版本的图标（叠加#c6e5ff颜色），并存在你的m_renderedObjectsModels中。
• 给QListView绑定entered和left信号，跟踪当前hover的项索引，然后触发模型数据更新。
• 在模型的data方法中，判断当前项是否处于hover状态，返回对应的hover图标或原始图标。

不过这种方案灵活性较差，需要额外维护状态，不如自定义委托来得直接。

补充说明 #

为什么选中后悬停会生效？因为Qt的默认样式在处理选中状态的项时，会自动对图标应用选中颜色的调色逻辑，而hover状态没有这个默认处理，所以需要我们手动实现。

内容的提问来源于stack exchange，提问作者Florian Blume