Codex
69 lines
2.7 KiB
Markdown
69 lines
2.7 KiB
Markdown
# BUG-20260415-0008
|
||
|
||
> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
|
||
|
||
## 基本信息
|
||
|
||
- ID: BUG-20260415-0008
|
||
- 标题: TabControl 页签层级与重复激活链路导致 Tooltip 和残影异常
|
||
- 状态：已修复
|
||
- 严重性：S2
|
||
- 优先级：P1
|
||
- 模块: TabControl / 页签绘制 / 外部激活页签
|
||
- 版本 / 分支: 当前工作区
|
||
- 环境: Windows / EasyX / KEY1 / KEY5
|
||
- 发现人: 用户
|
||
- 关联 Fix ID：Fix-BUG-20260415-0008
|
||
|
||
## 问题描述
|
||
|
||
- 现象:
|
||
- 有任意页签打开时，页签按钮 Tooltip 无法正常显示，只有全部页签关闭时正常。
|
||
- KEY1 中页签 1 的表格超出 TabControl 区域，外部按钮重复激活同一页签后，再切页或关闭页签会留下超出部分残影。
|
||
- 影响范围: TabControl 页签按钮 Tooltip、外部 `setActiveIndex()` 重复调用、页内超出页面边界绘制的控件。
|
||
- 期望结果:
|
||
- 页签按钮应始终位于页面之上，Tooltip 正常显示。
|
||
- 外部重复激活已激活页签不应破坏当前可见页面的快照链。
|
||
- 实际结果:
|
||
- 页签按钮 Tooltip 会被页面盖掉。
|
||
- 外部重复激活同一页签后，页内超出页面区域的 Table 在切页/关页时会残留。
|
||
|
||
## 复现信息
|
||
|
||
- 前置条件:
|
||
- KEY5：存在可见页面和页签按钮 Tooltip
|
||
- KEY1：页签 1 内的 Table 长于 TabControl 页面区域，存在外部按钮 `test`
|
||
- 复现步骤:
|
||
|
||
1. 在 KEY5 中打开任意页签，将鼠标移到页签按钮上触发 Tooltip。
|
||
2. 观察 Tooltip 是否被页面盖掉。
|
||
3. 在 KEY1 中点击一次 `test` 激活页签 1。
|
||
4. 再点击一次 `test`，然后切页或关闭页签 1。
|
||
|
||
- 复现概率：必现
|
||
- 最小复现 Demo：KEY5 TabControl 区、KEY1 页签 1 + 外部 `test` 按钮
|
||
- 证据：Tooltip 被页面覆盖；重复激活后切页/关页出现残影
|
||
|
||
## 初步分析
|
||
|
||
- 疑似位置:
|
||
- `TabControl::draw()`
|
||
- `TabControl::requestRepaint()`
|
||
- `TabControl::setActiveIndex()`
|
||
- `Button::setButtonClick()`
|
||
- 触发条件:
|
||
- 页签按钮先画、页面后画
|
||
- `TOGGLE` 同状态重复 set 仍触发 onToggleOn
|
||
- 相关线索:
|
||
- 页面绘制层级高于页签按钮时，页签 Tooltip 会被后画的页面盖掉
|
||
- 重复激活已激活页签会重复执行页面 `onWindowResize()` / `setIsVisible(true)` 链
|
||
- 最近相关改动：TabControl overlay / Tooltip 回归专项修复
|
||
|
||
## 跟踪信息
|
||
|
||
- 首次发现时间: 2026-04-15
|
||
- 最后更新时间: 2026-04-15
|
||
- 修复版本：当前工作区
|
||
- 验证版本：KEY1 / KEY5 编译级验证通过，待用户手测
|
||
- 备注：本次只修页签层级和重复激活链路，不扩到 TabControl 其它内部布局语义
|