MacOS下TextInput无法接收Ctrl+Alt组合键的问题求助

问题描述 #

在MacOS系统中使用QtQuick开发时，发现TextInput通过Keys.forwardTo转发按键事件到ListView后，带有Ctrl+Alt（Option）修饰符的组合键（如Ctrl+Alt+J/K）仅能捕获到按键释放事件，无法捕获按下事件。最小复现代码如下：

import QtQuick 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    visible: true
    width: 100; height: 100

    Column {
        id: col
        anchors.fill: parent
        TextInput {
            focus: true
            width: col.width
            Keys.forwardTo: [list]
        }
        ListView {
            id: list
            width: col.width
            height:100
            model: ListModel {
                ListElement {name: "1"}
                ListElement {name: "2"}
                ListElement {name: "3"}
            }
            highlight: Component { Rectangle { color: 'gray' } }
            delegate: Component { Text{ text: name } }
            Keys.onPressed: (event)=>{
                if (testKeyCombination(event, Qt.ControlModifier|Qt.AltModifier, Qt.Key_J)){
                    console.warn("J pressed");
                    incrementCurrentIndex();
                }
                else if (testKeyCombination(event, Qt.ControlModifier|Qt.AltModifier, Qt.Key_K)){
                    decrementCurrentIndex();
                    console.warn("K pressed");
                }
            }
            Keys.onReleased: (event)=>{
                 if (testKeyCombination(event, Qt.ControlModifier|Qt.AltModifier, Qt.Key_J))
                    console.warn("J released");
                 else if (testKeyCombination(event, Qt.ControlModifier|Qt.AltModifier, Qt.Key_K))
                    console.warn("K released");
            }
        }
    }

    function testKey(event, key) { return event.key === key }

    function testModifiers(event, modifiers)
    { return (event.modifiers & modifiers) === modifiers }

    function testKeyCombination(event, modifiers, key)
    { return testModifiers(event, modifiers) && testKey(event, key) }
}

问题原因 #

MacOS环境下，TextInput控件默认会消费部分带有修饰符的按键按下事件（尤其是与编辑操作相关的组合键），导致这类事件无法通过Keys.forwardTo转发到目标控件，仅未被消费的释放事件能被转发。

解决方案 #

在TextInput的Keys.onPressed事件中，拦截目标组合键并标记为未被消费，让事件可以继续转发到ListView：

修改TextInput部分的代码如下：

TextInput {
    focus: true
    width: col.width

    Keys.onPressed: {
        // 检测Ctrl+Alt+J或Ctrl+Alt+K组合键
        const isTargetCombo = (event.modifiers & (Qt.ControlModifier | Qt.AltModifier)) === (Qt.ControlModifier | Qt.AltModifier) &&
                              (event.key === Qt.Key_J || event.key === Qt.Key_K);
        if (isTargetCombo) {
            event.accepted = false; // 标记事件未被消费，允许转发
        }
    }

    Keys.forwardTo: [list]
}

原理说明 #

通过设置event.accepted = false，告诉Qt该按键事件没有被TextInput处理，会继续按照Keys.forwardTo的配置转发到ListView，这样ListView的Keys.onPressed就能正常捕获到组合键的按下事件。

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