Qt技术问题：如何在QVideoWidget中捕获鼠标移动？

因为QVideoWidget的视频渲染区域由内部底层组件处理，直接调用setMouseTracking(True)无法触发mouseMoveEvent。可以通过以下两种方式解决：

方法一：使用事件过滤器 #

通过事件过滤器捕获鼠标移动事件，绕过内部组件的事件拦截：

from PySide6 import QtWidgets as qtw
from PySide6 import QtMultimediaWidgets as qtmw
from PySide6 import QtCore as qtc

class MouseTracker(qtc.QObject):
    def eventFilter(self, obj, event):
        if event.type() == qtc.QEvent.MouseMove:
            print("鼠标移动坐标：", event.pos())
            # 返回True表示已处理事件，返回False可让事件继续传递
            return False
        return super().eventFilter(obj, event)

app = qtw.QApplication()

vw = qtmw.QVideoWidget()
vw.setMouseTracking(True)
# 给视频部件安装事件过滤器
tracker = MouseTracker()
vw.installEventFilter(tracker)

vw.show()
app.exec()

方法二：子类化QVideoWidget重写event方法 #

通过子类化部件，在事件到达内部组件前提前处理鼠标移动事件：

from PySide6 import QtWidgets as qtw
from PySide6 import QtMultimediaWidgets as qtmw
from PySide6 import QtCore as qtc

class TrackableVideoWidget(qtmw.QVideoWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setMouseTracking(True)
    
    def event(self, event):
        if event.type() == qtc.QEvent.MouseMove:
            print("鼠标移动中：", event.pos())
            # 允许事件继续传递，保证其他功能正常
            return False
        return super().event(event)

app = qtw.QApplication()

vw = TrackableVideoWidget()
vw.show()
app.exec()

原理说明 #

QVideoWidget的内部渲染组件会优先拦截鼠标事件，导致直接重写mouseMoveEvent无法生效。事件过滤器或重写event方法，能在事件被内部组件处理前捕获并响应，从而实现无按键状态下的鼠标移动追踪。

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