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 直接对接
|