Fix-BUG-20260415-0008

适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。

关联信息

根因:
- TabControl::draw() 与局部重绘顺序为“先页签按钮，后页面”，导致页签 Tooltip 被页面盖掉。
- Button::setButtonClick() 对 TOGGLE 没有做“同状态短路”，外部重复激活同一页签会重复触发 onToggleOnCallback。
- TabControl::setActiveIndex() 也没有对“目标已是当前激活页”做保护，导致当前可见页的 onWindowResize() / setIsVisible(true) 链被重复执行。
触发条件:
- 任意页打开时触发页签 Tooltip
- 外部对已激活页签再次 setActiveIndex()
为什么之前没发现: KEY1 外部按钮重复激活场景和 KEY5 页签 Tooltip 场景是后续专项回归才补出来的。
关键证据:
- 所有页关闭时页签 Tooltip 正常，说明问题在页面层级覆盖
- 只点一次外部激活正常，重复激活后残影出现，说明问题在重复回调链

修复思路:
- 把 TabControl 绘制/局部重绘顺序改为“先页面、后页签按钮”
- 给 TOGGLE 状态设置和 setActiveIndex() 增加同状态短路
关键改动:
- TabControl::draw() 改成先画页面、后画页签按钮
- TabControl::requestRepaint(this) 的局部提交顺序同步调整
- Button::setButtonClick() 在 TOGGLE 同状态时直接返回
- TabControl::setActiveIndex() 若目标已是当前激活页则直接返回
涉及文件 / 类 / 函数:
- TabControl.cpp
- Button.cpp
影响的 API / 行为:
- 重复设置相同 TOGGLE 状态不再重复触发回调
关键约束 / 不变量:
- 页签按钮视觉层级应始终高于页面
- 外部重复激活同一页签不应重新走页面显示链
回滚点 / 开关：无

影响范围: TabControl 页签 Tooltip、外部页签激活、页内超出页面边界的复合控件
兼容性影响：有（收紧了 TOGGLE 同状态重复 set 的回调语义）
行为变化：有（页签 Tooltip 层级恢复正确；重复激活同一页签不再重复触发回调）
性能影响：无
回归风险:
- 如有外部代码依赖“同状态重复 set 也要重复触发回调”，该行为将被收掉
- 需重点回归 KEY1 和 KEY5 的 TabControl 场景