mirror of
https://github.com/LHY0125/PathEditor.git
synced 2026-05-10 10:19:47 +08:00
66 lines
2.1 KiB
Markdown
66 lines
2.1 KiB
Markdown
# 撤销/重做 UI 集成 — 设计文档
|
||
|
||
## 背景
|
||
|
||
撤销/重做后端（`src/core/undo_redo.c`）已完整实现，支持 7 种操作类型的记录与回滚。所有 UI 操作（新建/编辑/删除/上移/下移/清理）均已调用 `push_undo_record()` 写入历史。但 `undo()` 和 `redo()` 函数未被任何 UI 代码调用——用户无法触发撤销或重做。
|
||
|
||
## 目标
|
||
|
||
在界面上添加撤销/重做按钮，并绑定 Ctrl+Z / Ctrl+Y 快捷键，让用户可以回退和恢复操作。
|
||
|
||
## 改动文件
|
||
|
||
| 文件 | 改动内容 |
|
||
|------|---------|
|
||
| `include/utils/ui_constants.h` | 新增 `CTRL_BTN_UNDO`、`CTRL_BTN_REDO` 常量 |
|
||
| `src/ui/main_window.c` | 创建撤销/重做按钮，绑定回调，调整布局 |
|
||
| `src/controller/callbacks_nav.c` | 新增 `btn_undo_cb`、`btn_redo_cb`，`list_k_any_cb` 增加 Ctrl+Z/Y 检测 |
|
||
| `lua/config.lua` | 新增 `button.undo`、`button.redo` 配置项 |
|
||
| `locale/` 翻译文件 | 同步新增按钮的中英文翻译 |
|
||
|
||
## 核心逻辑
|
||
|
||
```
|
||
btn_undo_cb(dlg):
|
||
ctx = get_app_context_from_dlg(dlg)
|
||
if !can_undo(ctx->undo_redo_mgr): return
|
||
undo(ctx->undo_redo_mgr, &ctx->sys_paths, &ctx->user_paths)
|
||
sync both lists to UI
|
||
update undo/redo button enabled state
|
||
|
||
btn_redo_cb(dlg):
|
||
同上，调用 redo()
|
||
|
||
list_k_any_cb:
|
||
新增分支:
|
||
if c == K_cZ → btn_undo_cb
|
||
if c == K_cY → btn_redo_cb
|
||
```
|
||
|
||
## 按钮布局
|
||
|
||
撤销/重做按钮放在上移/下移按钮下方：
|
||
|
||
```
|
||
[新建] [编辑]
|
||
[浏览] [删除]
|
||
(分隔)
|
||
[一键清理]
|
||
(分隔)
|
||
[导入] [导出]
|
||
[上移] [下移]
|
||
[撤销] [重做] ← 新增
|
||
```
|
||
|
||
## 按钮状态
|
||
|
||
- `can_undo() == false` → 撤销按钮 `ACTIVE=NO`
|
||
- `can_redo() == false` → 重做按钮 `ACTIVE=NO`
|
||
- 每次 undo/redo 执行后刷新按钮状态
|
||
|
||
## 不做的事
|
||
|
||
- 不修改 `undo_redo.c` 后端代码（已完备）
|
||
- 不添加操作历史面板（保持简洁，通过按钮状态反馈即可）
|
||
- 不在保存后清空历史（当前设计由 `clear_undo_redo_history` 决定，保持现有行为）
|