桌面应用 / 系统课时
处理键盘焦点与快捷操作
处理键盘焦点与快捷操作
桌面应用需要同时支持鼠标和键盘操作。本节通过 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: 后跟输入文本。处理焦点丢失与快捷键冲突
复杂窗口中可能同时存在输入框、菜单和快捷操作。设计快捷键时需要判断当前焦点对象,避免用户正在输入文本时触发全局动作。
例如保存快捷键通常只在非文本编辑状态下处理,或者让输入控件优先消费按键事件。合理的焦点设计可以让桌面应用行为更接近原生软件。
按自己的节奏,确认真正理解。