Codex
72 lines
2.9 KiB
Markdown
72 lines
2.9 KiB
Markdown
# Fix-BUG-20260415-0007
|
||
|
||
> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
|
||
|
||
## 关联信息
|
||
|
||
- Fix ID: Fix-BUG-20260415-0007
|
||
- 关联 BUG ID: BUG-20260415-0007
|
||
- 修复目标: 让托管 coverage 与 overlay 补画基于实际绘制范围，而非控件本体 bounds
|
||
- 状态：已完成
|
||
- 负责人: Codex
|
||
- 分支 / 版本: 当前工作区
|
||
|
||
## 根因分析
|
||
|
||
- 根因: `Window / Canvas / TabControl` 的 coverage 计算链默认使用 `getBoundsRect()`，没有把 Tooltip 这类附加绘制区域纳入。
|
||
- 触发条件: 控件本体未与 overlay 相交，但附加绘制区域超出本体并写入更上层区域。
|
||
- 为什么之前没发现: 第一轮主要解决普通控件和顶层 overlay；Tooltip 属于本体外附加绘制，直到 C / D 交界回归才稳定暴露。
|
||
- 关键证据:
|
||
- 顶层按钮 Tooltip 正常，但容器内按钮 Tooltip 压到 D 橙区
|
||
- 根因与按钮本体 bounds 无关，与 Tooltip 超出范围有关
|
||
|
||
## 修复方案
|
||
|
||
- 修复思路: 引入“实际绘制 coverage”接口，让托管重绘与局部提交统一走真实覆盖范围。
|
||
- 关键改动:
|
||
- 在 `Control` 增加 `getManagedRepaintCoverageRect()`
|
||
- `Button` 在 Tooltip 可见时返回“按钮矩形 + Tooltip 矩形”的并集
|
||
- `Canvas / TabControl / Table` 将可见内部绘制单元 coverage 递归并入
|
||
- `Window::requestManagedRepaint()` 和顶层 overlay 重组改为走 coverage 接口
|
||
- 涉及文件 / 类 / 函数:
|
||
- `Control.h / Control.cpp`
|
||
- `Button.h / Button.cpp`
|
||
- `Canvas.h / Canvas.cpp`
|
||
- `TabControl.h / TabControl.cpp`
|
||
- `Table.h / Table.cpp`
|
||
- `Window.cpp`
|
||
- 影响的 API / 行为：新增内部 virtual 接口，无公开 API 变化
|
||
- 关键约束 / 不变量:
|
||
- Tooltip 智能选位不在本次修复范围内
|
||
- overlay 补画继续按父容器真实绘制顺序工作
|
||
- 回滚点 / 开关：无
|
||
|
||
## 影响评估
|
||
|
||
- 影响范围: Tooltip、overlay 补画、复杂容器内附加绘制区域
|
||
- 兼容性影响：无
|
||
- 行为变化：有（Tooltip 与 overlay 层级恢复正确）
|
||
- 性能影响：有（coverage 更保守，可能触发更多 overlay 补画）
|
||
- 回归风险:
|
||
- coverage 扩大后顶层/容器层局部提交会多画一些 overlay
|
||
- 需重点回归 Tooltip 与多跳 overlay 场景
|
||
|
||
## 验证结果
|
||
|
||
- 验证步骤:
|
||
|
||
1. 编译 `Control.cpp / Button.cpp / Canvas.cpp / TabControl.cpp / Table.cpp / Window.cpp / z-testDome.cpp`
|
||
2. 在 KEY5 中验证 C 米区容器内按钮 Tooltip 与 D 橙区的遮挡关系
|
||
3. 回归顶层按钮 Tooltip、页签按钮 Tooltip、浮层按钮 Tooltip
|
||
|
||
- 验证结果: 编译通过；逻辑推演闭合；GUI 需用户本机手测
|
||
- 回归检查：KEY5 C/D 交界区、TabControl 页签、三层嵌套按钮 Tooltip
|
||
- 验证证据：编译级验证通过
|
||
|
||
## 落地信息
|
||
|
||
- Commit: 未单独提交
|
||
- PR：[可选]
|
||
- 发布版本：[可选]
|
||
- 备注：Tooltip 智能选位明确延期，本次只修“coverage 正确性”
|