Qt中父控件拖拽至子控件时子控件无法捕获鼠标事件如何解决

这不是项目控件结构复杂导致的事件阻断，是Qt默认的鼠标事件分发规则：当鼠标在某个控件上触发press事件后，Qt会自动把这次按压操作从按下到释放全程的所有鼠标事件（移动、释放、进出控件等）全部分发给接收press事件的控件，也就是你场景中的父widget。这个阶段不管鼠标移动到哪个子控件区域，子控件都收不到任何鼠标事件，这个设计本身是为了保证普通点击、拖拽交互的连贯性，避免事件中途跳转导致逻辑错乱。

根据你的实现场景选对应方案即可：

方案1：用Qt原生拖拽框架（优先推荐，适配成本最低） #

不要手动靠mousePress/mouseMove/mouseRelease三个事件硬写拖拽逻辑，直接用Qt内置的Drag&Drop能力，从机制上规避事件捕获冲突：

• 在父widget中，检测到鼠标移动距离满足拖拽触发阈值时，创建QDrag对象启动拖拽，需要传递的拖拽数据封装到QMimeData中绑定给QDrag对象
• 给目标子widget调用setAcceptDrops(true)，按需重写子widget的dragEnterEvent、dragMoveEvent、dropEvent、dragLeaveEvent，分别处理拖拽进入、在控件内移动、松开鼠标完成拖放、拖拽离开控件的逻辑
  原生框架会自动处理跨控件的事件路由，不会出现父控件独占鼠标事件的问题。

方案2：自定义模拟拖拽的适配 #

如果因为业务特殊要求必须手动实现拖拽逻辑，不使用原生QDrag，可以用下面两个轻量方案解决：

• 主动释放鼠标捕获：在父widget的mouseMoveEvent回调里实时检测光标坐标，当光标进入子widget的区域时，调用父widget的releaseMouse()方法主动释放鼠标独占捕获，之后的鼠标移动、释放事件就会正常派发给光标下方的子widget。
• 手动转发事件：如果需要更灵活的拖拽控制，可以在拖拽激活状态下给QApplication安装全局事件过滤器，拿到全局鼠标事件后根据当前光标位置，手动把事件派发给对应的目标控件，这个方案适合控件嵌套层级特别深、逻辑复杂的场景。

不要通过给父控件临时设置Qt::WA_TransparentForMouseEvents属性的方式绕开事件捕获，这种方式很容易破坏父控件本身其他正常的鼠标交互，后续出问题排查成本极高。

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