# BUG-20260109-0002

> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。

## 基本信息

- ID: BUG-20260109-0002
- 标题: TabControl 切换后 Table 新旧内容重叠
- 状态：已修复
- 严重性：S2
- 优先级：P1
- 模块: TabControl / Canvas / Table / 背景快照 / 脏标记重绘链路
- 版本 / 分支: 基础版（EasyX + Win32）/ v2.3.2
- 环境: Windows x64 / Visual Studio 2022 / EasyX（Debug / Release 均可能）
- 发现人: 用户
- 关联 Fix ID: Fix-BUG-20260109-0002

## 问题描述

- 现象: 运行 TabControl 示例后，切换到“按钮1”页签并触发“重置表格数据”，随后打开 / 关闭其他页签再切回“按钮1”，Table 稳定出现旧内容与新内容叠加；偶发情况下重置数据当次即出现重影。
- 影响范围: 使用背景快照擦除与局部重绘组合的容器 / 控件，尤其是 Table 透明文字背景与 Null 填充模式场景。
- 期望结果: 切换页签、关闭页签、重置数据后，Table 只显示当前数据，不残留旧像素。
- 实际结果: Table 区域出现旧行文本像素残留，与新内容叠在同一位置。

## 复现信息

- 前置条件：[可选] TabControl 示例中包含 Table 和“重置表格数据”按钮。
- 复现步骤:

1. 运行测试程序（TabControl 示例）。
2. 切换到“按钮1”页签。
3. 点击“重置表格数据”（清空并重新 `setData()`）。
4. 随意切换到其他页签，可伴随关闭页签操作。
5. 再切回“按钮1”。
6. 观察 Table 区域是否出现旧内容与新内容重叠。

- 复现概率：必现；重置数据当次直接重影为偶现。
- 最小复现 Demo：`z-testDome.cpp` 中 TabControl + Table + 重置按钮场景；Null FillMode 与透明文字背景更明显。
- 证据：日志显示 Canvas 快照刚丢弃或未就绪时，Table 可见性恢复立即触发局部重绘，随后 `saveBackground()` 把已绘制像素截入背景快照。

## 初步分析

- 疑似位置:
  - `Control::setIsVisible(true)`
  - `Canvas::requestRepaint()`
  - `TabControl::requestRepaint()`
- 触发条件: 页签切换 / 关闭期间，父容器快照未就绪或 dirty 未清理时，子控件抢跑执行局部绘制。
- 相关线索:
  - `show=true` 时立即向上 `requestRepaint()`。
  - `Canvas::requestRepaint()` 在 `hasSnap=0` / `dirty=1` 状态下仍允许对子控件局部 `draw()`。
  - 页签切换期间尺寸变化会触发丢背景快照和标脏。
- 最近相关改动：[可选] `Control::setIsVisible(true)` 变为立即请求重绘。

## 跟踪信息

- 首次发现时间: 2026-01-09
- 最后更新时间: 2026-09-19（从 PDF 整理入库）
- 修复版本: v3.0.0
- 验证版本：[可选] v3.0.0
- 备注：[可选] 来源原始 ID 为 `BUG-20260109`；同日另有 TextBox 生命周期问题，入库时按顺序拆为 `0001` 与 `0002`。