XCEngine/docs/plan/xcui-subplans/Subplan-04_XCUI-Input-Focus-Shortcut.md

Subplan 04：XCUI Input / Focus / Shortcut

状态：

• 已于 2026-04-04 完成当前 subplan 定义边界内的实现。
• 已归档到： ../used/XCUI_Input_Focus_Shortcut_Subplan_完成归档_2026-04-04.md

目标：

• 建立 XCUI 的输入事件、焦点流转和快捷键分发模型。
• 让输入不再直接写死在 ImGui 调用点里。

负责人边界：

• 负责 engine/src/UI/Input/。
• 负责 pointer / keyboard / focus / command dispatch 的抽象。
• 不负责平台消息采集本身。

建议目录：

• engine/include/XCEngine/UI/Input/
• engine/src/UI/Input/
• tests 中 input/focus 测试

前置依赖：

• 依赖 Subplan 01 的 tree 和 hit-test 基础契约。
• 需要和 Subplan 05 对齐 adapter 输入桥接接口。

现在就可以先做的内容：

• 设计 UIInputEvent 丰富版本
• 设计 focus path / active path / capture path
• 设计 shortcut scope：global / window / panel / widget
• 写 focus 切换和冒泡/捕获测试

明确不做：

• 不做 Win32 原生消息处理细节
• 不做具体文本输入 widget

交付物：

• XCUI 输入分发器
• 焦点管理器
• 快捷键绑定与分发机制

验收标准：

• 可以确定事件从哪里来、往哪里走、谁消费
• 焦点切换规则稳定可测
• 快捷键系统可与 editor shell 直接对接