QML焦点切回原Item后Keys.onPressed无法捕获HID扫码枪输入问题

问题根因 #

该故障是Qt Quick焦点机制、输入事件双通道分发逻辑共同作用的结果，和扫码枪硬件本身无关：

• Qt Quick的输入事件本身走两条完全独立的通道：
  • 原始按键通道：事件直接分发给Window当前的activeFocusItem，普通物理键盘的输入默认走这条通道
  • 输入法事件通道：事件由系统输入上下文接管分发，目标对象是最近一次注册的文本输入类控件；扫码枪这类模拟快速连续输入的HID设备，大多会通过这条通道上报输入
• 故障的完整触发链路和上述机制完全匹配：
  1. 应用启动初始状态：没有其他输入类控件注册过输入法接收对象，Window的activeFocusItem就是keyboardHandler，两条输入通道的目标都指向它，因此扫码枪输入可以被正常捕获
  2. 点击TextField后：TextField将自身注册为输入法通道的接收对象，同时成为Window的activeFocusItem
  3. 点击全屏图像切回焦点时：代码仅设置了keyboardHandler.focus = true，既没有显式清除TextField的焦点状态，也没有主动刷新Window的activeFocusItem。此时因为keyboardHandler的focus属性为true，它可以正常收到原始按键通道的物理键盘输入事件，但TextField仍霸占着输入法通道的接收权限，扫码枪的输入事件全部被TextField拦截，根本不会分发到keyboardHandler上
• 调用forceActiveFocus()无效的原因：forceActiveFocus仅会将当前Item设置为自身父级焦点链的激活项，但不会主动解绑TextField之前在输入上下文上注册的接收关系，只要TextField自身的focus属性没有被置为false，它就会持续接收输入法通道的输入。

注意：Qt Quick的Item自身focus属性仅代表该Item愿意接收焦点，不代表它就是当前真正能接收输入的激活焦点项——多个同层级Item可以同时将focus设为true，只有最终沿控件树向上传递到Window的焦点项，才会被设置为activeFocusItem。

修复方案 #

修改全屏图像组件的点击逻辑，在切换焦点前先显式清除残留的输入控件焦点，再主动更新Window的激活焦点项：

Image {
    id: focusToKeyboardHandler
    anchors.fill: parent
    MouseArea {
        anchors.fill: parent
        onClicked: {
            // 先显式清除测试文本框的残留焦点
            textfieldID.focus = false
            // 给扫码枪输入处理组件赋值焦点
            keyboardHandler.focus = true
            // 主动刷新Window级别的激活焦点项，避免通道残留
            mainWindow.activeFocusItem = keyboardHandler
        }
    }
}

额外调试建议 #

• 不要仅通过单个Item的focus属性判断焦点状态，一定要打印ApplicationWindow.activeFocusItem的实际值，确认全局焦点的分发是否符合预期
• 若扫码枪输入仍有拦截问题，可以在keyboardHandler组件上添加顶层优先级焦点声明，同时补充监听Keys.onReleased事件，避免特殊按键被系统事件链拦截

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