为什么运行在QQuickWidget上的QML Menu设置id后点击外部不会关闭?
问题根因
该异常是Qt 5.13.x、5.14.x版本中Controls 2组件与QQuickWidget离屏渲染模式组合下的已知缺陷,核心逻辑关联QML组件作用域调整与Popup(Menu的父类)的事件过滤器安装流程:
- 当Menu未设置id时,它会被识别为ComboBox
popup属性的内联绑定组件,直接在ComboBox的组件上下文中实例化。这种场景下,Popup的外部按压监听事件过滤器会正确挂载到QQuickWidget对应的原生窗口链路中,closePolicy可以正常生效。 - 为Menu添加id后,QML引擎会重新调整组件作用域:Menu不再是ComboBox的内联弹层组件,而是被标记为根作用域下可独立访问的子组件。对于采用离屏渲染模式的QQuickWidget而言,Popup的事件过滤器无法正确匹配到目标原生窗口,收不到外部按压事件,导致无论如何配置
closePolicy都无法触发自动关闭。
该问题仅在QQuickWidget渲染场景下出现:如果使用常规QQuickView、QGuiApplication承载的QML界面,即使给Menu设置id,事件过滤器也能正常挂载到顶层QQuickWindow,不会出现该异常。
解决思路
- 方案1:保持Menu不设置id,通过ComboBox实例访问弹层
如果需要在其他逻辑中引用Menu实例,不要依赖id直接访问,统一通过ComboBox实例的popup属性获取Menu的引用,既保留原有的正常交互逻辑,也不影响代码可读性:ComboBox { id: comboBox popup: Menu { // 不设置id } // 操作弹层的逻辑直接引用comboBox.popup,例如: Component.onCompleted: comboBox.popup.addItem("测试选项") } - 方案2:保留Menu的id属性,手动实现外部点击关闭逻辑
如果因为代码结构原因必须保留id,可先将失效的默认自动关闭策略禁用,手动实现外部按压检测逻辑:ComboBox { popup: Menu { id: menu closePolicy: Popup.NoAutoClose // 禁用失效的默认自动关闭逻辑 // 补充Esc键关闭逻辑 Shortcut { sequences: ["Esc"] context: Qt.WindowShortcut onActivated: menu.close() } // 监听窗口按压事件,判断点击位置是否在弹层外部 Connections { target: window function onPressed(mouseEvent) { if (menu.visible && !menu.contains(mouseEvent.x, mouseEvent.y)) { menu.close() } } } } } - 方案3:升级Qt版本
该缺陷已在Qt 5.15.0及后续版本中修复,Controls 2的Popup事件过滤逻辑补充了对QQuickWidget离屏渲染场景的兼容,设置id后closePolicy的行为会恢复正常。
内容的提问来源于stack exchange,提问作者Kazuto_Ute
相关产品推荐
相关产品推荐

