54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
|
# Subplan 04：XCUI Input / Focus / Shortcut
|
|||
|
|
|
|||
|
|
状态：
|
|||
|
|
|
|||
|
|
- 已于 `2026-04-04` 完成当前 subplan 定义边界内的实现。
|
|||
|
|
- 已归档到：
|
|||
|
|
[../used/XCUI_Input_Focus_Shortcut_Subplan_完成归档_2026-04-04.md](../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 直接对接
|