如何在PyQt6/PySide6中检测QComboBox下拉项悬停并获取项对象

要实现鼠标悬停在QComboBox下拉列表项上时获取对应项对象，进而实现样式表无法完成的颜色过渡动画，核心是要操作QComboBox的下拉视图控件，以下是具体实现方案：

实现步骤 #

1. 获取QComboBox的下拉视图：通过view()方法获取下拉列表对应的QAbstractItemView对象，这是所有下拉项的载体。
2. 为视图安装事件过滤器：监听鼠标移动事件，实时获取鼠标位置对应的项索引。
3. 自定义项代理（可选）：通过QStyledItemDelegate可以更灵活地处理项的样式与动画逻辑。

修改后的完整代码 #

from PySide6.QtCore import QEvent, Qt, QPropertyAnimation
from PySide6.QtWidgets import QApplication, QWidget, QComboBox, QVBoxLayout, QStyledItemDelegate, QStyleOptionViewItem
import sys


class HoverItemDelegate(QStyledItemDelegate):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.animation = None

    def initStyleOption(self, option: QStyleOptionViewItem, index):
        super().initStyleOption(option, index)
        # 检测鼠标悬停状态
        if option.state & QStyleOptionViewItem.State_MouseOver:
            # 示例：实现背景色过渡动画
            if not self.animation or self.animation.targetObject() != option.widget:
                self.animation = QPropertyAnimation(option.widget, b"styleSheet")
                self.animation.setDuration(200)
            self.animation.setStartValue("background-color: white;")
            self.animation.setEndValue("background-color: #e0e0e0;")
            self.animation.start()
        else:
            option.widget.setStyleSheet("background-color: white;")


class MainWidget(QWidget):
    def __init__(self):
        super().__init__()
        
        self.combo_box = QComboBox(self)
        self.combo_box.addItem('Item 1')
        self.combo_box.addItem('Item 2')
        self.combo_box.addItem('Item 3')
        main_layout = QVBoxLayout()
        main_layout.addWidget(self.combo_box)

        # 获取下拉视图并安装事件过滤器
        self.combo_view = self.combo_box.view()
        self.combo_view.installEventFilter(self)
        
        # 设置自定义代理处理动画
        self.hover_delegate = HoverItemDelegate()
        self.combo_view.setItemDelegate(self.hover_delegate)

    def eventFilter(self, obj, ev):
        if obj == self.combo_view:
            if ev.type() == QEvent.MouseMove:
                # 获取当前鼠标位置对应的项索引
                index = self.combo_view.indexAt(ev.pos())
                if index.isValid():
                    # 获取项文本
                    item_text = index.data(Qt.DisplayRole)
                    # 获取QStandardItem对象（QComboBox默认模型）
                    item_obj = self.combo_box.model().item(index.row())
                    print(f"悬停项文本：{item_text}，项对象：{item_obj}")
        return super().eventFilter(obj, ev)


app = QApplication(sys.argv)
window = MainWidget()
window.show()
app.exec()

关键说明 #

• 下拉视图获取：self.combo_box.view()直接拿到下拉列表的视图控件，所有项的交互事件都在这里触发。
• 事件过滤器：监听MouseMove事件，通过indexAt(ev.pos())将鼠标坐标转换为模型索引，判断索引有效后即可获取项的文本、对象等信息。
• 自定义代理与动画：HoverItemDelegate中利用QPropertyAnimation实现背景色的过渡动画，这是样式表无法直接实现的动态效果。
• 关于highlighted信号：该信号主要响应键盘导航或选中项的高亮切换，无法实时跟随鼠标移动触发每一个项的悬停事件，因此事件过滤器是更合适的选择。

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