重构(UI): 统一组件协议 + 去手写链路 + 大文件按职责拆分 + 代码审查 + 剥离 Tools
## 1. 新增 UiComponent 顶层组件协议（不是负优化）
Components/Shared/Inc/UiComponent.hpp：纯接口、无状态，8 个方法
SetScale / Layout / Area / Paint / HitTest / OnMouseLeave / IsEditing / QueryCursor。
Toolbar / TabBar / SignalPanel / PlotView 本来就各自拥有完全同名同签名的成员，
因此改造 = 加 override + 补 Area()（PlotView 另加一个非 const 的 QueryCursor 转发，
因为它自己的查询会惰性建立行缓存），实现代码零改动、静态派发、体积无增长。
刻意不把 UiWidget 当作它的基类：UiWidget 是"树节点"（父给尺寸、父下探脏区、
命中沿树链派发），而 PlotView（4 层位图缓存）/ SignalPanel（行位图缓存）是
"地盘宿主"。强行上树会推翻"父脏则子全脏"的前提，历史上正是这类耦合导致过
"后台渲染覆盖平移结果""命中矩形错位"的事故。头文件里已写明这条理由。
Toolbar/TabBar 是两者的交集：对外实现 UiComponent，对内持有一棵 UiWidget 树。
## 2. 宿主侧：四条手写链 -> 组件表
Application 新增 ComponentEntry{ component, target, chrome } 与 m_components
（底->顶：plot -> panel -> toolbar -> tabBar），BuildComponentTable() 装配一次。
- ApplyDpi 6 行逐个 SetScale -> 1 个循环
- Relayout 手算三列 x 坐标 -> UiStackRects(内容区, HORIZONTAL, {panelW, splitW, AUTO})
- WM_MOUSELEAVE 逐个 OnMouseLeave -> 循环累积 chromeChanged / plotChanged
- WM_SETCURSOR if/else if 链 -> 从表尾向前找首个命中者，取其 QueryCursor
顺带兑现历史缺口：UiLayout::UiStackRects 自引入以来第一次有了生产调用点。
有意保留显式的三条链（WM_LBUTTONDOWN / WM_LBUTTONUP / WM_MOUSEMOVE）：它们各自带
组件专属后置动作（提交重命名、构建派生信号、面板联动滚动、更新拖拽光标、
plotOnlyMove 决定局部失效还是整帧失效）。塞进表里只能靠 lambda 字段，
可读性反而下降 —— 属于用户明确禁止的"过度抽象"，因此不做。
## 3. 大文件按职责拆分（纯整函数搬移，逐像素 0 差异）
SignalPanelInteraction.cpp 2329 -> 831 行，拆出：
SignalPanelEdit.cpp 616 内联编辑（筛选框、组名/信号名、数值、颜色与透明度）
SignalPanelScroll.cpp 205 动画与滚动（折起、联动滚动、滚动到目标信号）
SignalPanelMenu.cpp 527 弹出菜单（系数/偏移、镜像、右键菜单与命令回执）
Shared/PopupMenu.cpp 1901 -> 706 行，拆出：
PopupMenuLayout.cpp 753 尺寸测量、项矩形排版、滚动可见性
PopupMenuPaint.cpp 397 背景/阴影/项绘制
Inc/PopupMenuInternal.hpp 103 pmdetail 常量 + inline 辅助（跨 TU 安全）
拆分判据是"职责"而非行数；共享常量一律收敛到 *Internal.hpp。
## 4. 代码审查（修 5 处）
- SignalPanelInteraction.cpp 头注释仍写"4 片"，实际 6 片 -> 改为完整清单
- PopupMenuLayout.cpp 机械搬移时把构造函数一起搬走 -> 重复定义，只保留在交互分片
- PopupMenu.cpp 的 #include "PopupMenuInternal.hpp" 落进 namespace jdi 内 -> 移到文件头
- PopupMenuPaint.cpp 缺 UiControls.hpp（UiDrawEditFieldContent 未声明）-> 补 include
- 全仓复查历史删除符号残留引用（m_paintPlot / ClampCursorsAfterPan /
PaintFreeMarkerTooltip / CaptureDecorCache / FitSinglePointSignal / CsvTable /
DataFile / .preflight / structcheck）-> 零命中
## 5. Tools/ 剥离
git rm -r --cached Tools + .gitignore 新增 Tools/（本地文件保留，可随时复跑）。
ui_refactor 分支为全本地分支，另做 filter-branch 清除历史中的该目录。
## 6. 验证
- make release / make debug：零 error 零 warning
- rendercheck：A-H 八个场景哈希与改造前逐一相同
(A 2166933039626F66 B C444ECFEB18FD73D C 7984446D8E7A4418 D BF855879CA12F289
E 1C663E4118616016 F 0535292D8E07AE18 G 7A58172C46577729 H 23F390DD76141113)
FUNC 7/7 PASS
- uicheck：69 passed, 0 failed
- TargetCheck.exe 891,392 B（< 900 KB 阈值）
## 7. 文档
Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md
新增第五阶段章节；Documents/agent_mem.md 同步变更日志与「第七轮」硬约束。
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
675c2a5f54
commit
0ec8055e95
20 files changed
+3287
-2678
No files matched your search
@@ -20,6 +20,7 @@
|
||||
#include "DataModel.hpp"
|
||||
#include "PaintUtil.hpp"
|
||||
#include "Theme.hpp"
|
||||
#include "UiComponent.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
@@ -140,7 +141,7 @@ namespace jdi
|
||||
* 绘图区同时依赖数据层（DataSet，只读）与当前标签页配置（TabConfig，可写），
|
||||
* 视图范围、网格滚动与时间光标均保存在标签页配置中，因此各标签页互不干扰。
|
||||
*/
|
||||
class PlotView
|
||||
class PlotView : public UiComponent
|
||||
{
|
||||
public:
|
||||
PlotView();
|
||||
@@ -186,19 +187,22 @@ namespace jdi
|
||||
* @brief 设置 DPI 缩放比例。
|
||||
* @param [IN] scale 缩放比例（1.0 对应 96 DPI）。
|
||||
*/
|
||||
void SetScale(float scale);
|
||||
void SetScale(float scale) override;
|
||||
|
||||
/**
|
||||
* @brief 按给定区域重新排布绘图区。
|
||||
* @param [IN] area 可用区域。
|
||||
*/
|
||||
void Layout(const gd::RectF& area);
|
||||
void Layout(const gd::RectF& area) override;
|
||||
|
||||
/** @brief 绘图区占用的整块区域（与 `Layout` 同源）。 */
|
||||
gd::RectF Area() const override { return m_area; }
|
||||
|
||||
/**
|
||||
* @brief 绘制绘图区。
|
||||
* @param [IN,OUT] g 绘图上下文。
|
||||
*/
|
||||
void Paint(gd::Graphics& g);
|
||||
void Paint(gd::Graphics& g) override;
|
||||
|
||||
/**
|
||||
* @brief 处理鼠标移动（含拖拽）。
|
||||
@@ -292,7 +296,7 @@ namespace jdi
|
||||
* @brief 处理鼠标离开绘图区。
|
||||
* @return 需要重绘返回 true。
|
||||
*/
|
||||
bool OnMouseLeave();
|
||||
bool OnMouseLeave() override;
|
||||
|
||||
/**
|
||||
* @brief 将时间轴自适应到指定网格内信号的时间范围。
|
||||
@@ -466,7 +470,7 @@ namespace jdi
|
||||
* @param [IN] y 客户区纵坐标。
|
||||
* @return 落在范围内返回 true。
|
||||
*/
|
||||
bool HitTest(int x, int y) const;
|
||||
bool HitTest(int x, int y) const override;
|
||||
|
||||
/**
|
||||
* @brief 查询当前鼠标位置应使用的系统光标。
|
||||
@@ -476,6 +480,17 @@ namespace jdi
|
||||
*/
|
||||
HCURSOR QueryCursor(int x, int y) const;
|
||||
|
||||
/**
|
||||
* @brief `UiComponent` 协议的入口（转调上面的 const 版本）。
|
||||
*
|
||||
* `UiComponent` 声明的是非 const 版本（`SignalPanel` 的命中需要惰性重建行集合），
|
||||
* 而绘图区的实现天然是 const；这里做一次薄转发，两个重载保持行为完全一致。
|
||||
*/
|
||||
HCURSOR QueryCursor(int x, int y) override
|
||||
{
|
||||
return static_cast<const PlotView*>(this)->QueryCursor(x, y);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 「适应视图」：时间轴与幅值轴同时自适应到可见信号范围。
|
||||
*
|
||||
@@ -1083,7 +1098,7 @@ namespace jdi
|
||||
* @brief 判断是否处于任意内联数值输入状态。
|
||||
* @return 处于编辑态返回 true。
|
||||
*/
|
||||
bool IsEditing() const { return m_editTarget != PlotEditTarget::NONE; }
|
||||
bool IsEditing() const override { return m_editTarget != PlotEditTarget::NONE; }
|
||||
|
||||
/**
|
||||
* @brief 取出并清除待应用的信号重命名请求。
|
||||
|
||||
Reference in new issue
Block a user