QListView鼠标离开后ListViewItem仍处于MouseOver状态的问题求助

我之前也碰到过一模一样的情况，在Qt 5.x版本里单纯调用update()经常没法正确清除最后一个悬停项的状态，核心问题在于视图没有明确通知委托：「这个项现在已经不被鼠标悬停了」。下面给你几个可行的解决方案，按推荐程度排序：

方案一：跟踪并强制更新最后悬停的索引 #

这个方法最可靠，通过记录鼠标移动时的悬停索引，在鼠标离开时专门更新这个索引的区域，确保委托收到正确的状态。

1. 先在自定义MyListView类里加个成员变量，用来记录最后悬停的索引：

private:
    QModelIndex m_lastHoverIndex;

2. 在构造函数里开启鼠标跟踪（必须开，不然mouseMoveEvent不会持续触发）：

MyListView::MyListView(QWidget *parent) : QListView(parent)
{
    setMouseTracking(true);
}

3. 重写mouseMoveEvent，跟踪悬停索引的变化并更新对应项：

void MyListView::mouseMoveEvent(QMouseEvent *event)
{
    QModelIndex currentHoverIndex = indexAt(event->pos());
    // 如果悬停索引变了，更新前后两个项的状态
    if (currentHoverIndex != m_lastHoverIndex) {
        if (m_lastHoverIndex.isValid()) {
            update(m_lastHoverIndex); // 清除之前的悬停状态
        }
        m_lastHoverIndex = currentHoverIndex;
        if (m_lastHoverIndex.isValid()) {
            update(m_lastHoverIndex); // 绘制新的悬停状态
        }
    }
    QListView::mouseMoveEvent(event);
}

4. 最后在leaveEvent里清除最后悬停项的状态：

void MyListView::leaveEvent(QEvent *event)
{
    if (m_lastHoverIndex.isValid()) {
        update(m_lastHoverIndex); // 强制重绘最后悬停的项，此时状态会恢复正常
        m_lastHoverIndex = QModelIndex(); // 重置索引
    }
    QListView::leaveEvent(event);
}

方案二：更新视图的视口而非整个Widget #

有时候调用update()会更新整个QListView组件（包括边框等非内容区域），却没正确触发布局内项的状态更新，试试替换成更新视口：

void MyListView::leaveEvent(QEvent *event)
{
    QListView::leaveEvent(event);
    viewport()->update(); // 直接更新绘制项的视口区域
}

这个方法更简单，但在某些Qt版本或窗口管理器环境下可能不如方案一稳定，你可以先试试这个快速方案。

方案三：在委托中额外校验鼠标是否在视图内 #

如果不想修改ListView的代码，可以在委托的paint方法里，除了检查State_MouseOver，额外判断鼠标是否还在视图内：

void MyDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    bool reallyHovered = false;
    // 先检查标准悬停状态，再确认鼠标是否还在视图里
    if (option.state & QStyle::State_MouseOver) {
        if (QWidget *view = option.widget) {
            reallyHovered = view->underMouse();
        }
    }

    if (reallyHovered) {
        // 绘制悬停状态
    } else {
        // 正常绘制
    }
}

这个方法把状态判断逻辑放到了委托里，不需要修改ListView，但依赖option.widget的有效性，适合不想改动视图代码的场景。

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