桌面应用 / 系统课时

处理键盘焦点与快捷操作

处理键盘焦点与快捷操作

桌面应用需要同时支持鼠标和键盘操作。本节通过 activeFocus、Tab 焦点链和 Keys 处理器,让 QML 界面中的输入控件获得稳定的键盘交互能力。

学习目标

  • 理解 QML 焦点系统中 activeFocus 的作用。
  • 使用 Tab 键组织控件间的焦点移动。
  • 使用 Keys 处理器实现快捷操作。

理解 QML 键盘焦点模型

QML 中的键盘事件不会直接发送给所有控件,而是发送给当前拥有焦点的对象。activeFocus 表示对象当前是否真正获得输入焦点,而 focus 只是请求该对象参与焦点竞争。

桌面界面中常见的问题是按钮可以点击但无法通过键盘触发,或者输入框之间无法使用 Tab 切换。这通常与焦点链没有正确建立有关。

使用 focus 和 Tab 构建焦点链

可交互控件需要设置合理的焦点策略。通常将默认操作控件设置为初始焦点,再通过控件顺序让用户使用 Tab 完成导航。

qml
import QtQuick
import QtQuick.Controls

ApplicationWindow {
    visible: true
    width: 400
    height: 300

    Column {
        anchors.centerIn: parent
        spacing: 12

        TextField {
            id: username
            placeholderText: "用户名"
            focus: true
        }

        TextField {
            id: password
            placeholderText: "密码"
        }

        Button {
            text: "登录"
            onClicked: console.log("login")
        }
    }
}

预期结果

text
窗口启动后用户名输入框获得焦点,按 Tab 可以依次移动到密码输入框和登录按钮。

使用 Keys 处理快捷操作

Keys 处理器适合处理当前焦点对象相关的快捷键,例如回车提交、Esc 关闭弹窗等。它不会替代按钮点击逻辑,而是提供键盘入口。

qml
import QtQuick
import QtQuick.Controls

Item {
    width: 300
    height: 200

    TextField {
        id: searchInput
        anchors.centerIn: parent
        focus: true

        Keys.onReturnPressed: {
            console.log("search:", text)
        }
    }
}

预期结果

text
用户输入内容并按 Enter 后,控制台输出 search: 后跟输入文本。

处理焦点丢失与快捷键冲突

复杂窗口中可能同时存在输入框、菜单和快捷操作。设计快捷键时需要判断当前焦点对象,避免用户正在输入文本时触发全局动作。

例如保存快捷键通常只在非文本编辑状态下处理,或者让输入控件优先消费按键事件。合理的焦点设计可以让桌面应用行为更接近原生软件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理键盘焦点与快捷操作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通