StellarX-kaifa/开发记录/BUG/BUG-20261009-0001-Table内部分页按钮焦点视觉延迟刷新.md

BUG-20261009-0001

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

基本信息

• ID: BUG-20261009-0001
• 标题: Table 内部分页按钮焦点视觉延迟刷新
• 状态：已修复，自动回归通过，KEY1 人工复验待执行
• 严重性：S2
• 优先级：P1
• 模块: Focus / Table / Managed Repaint
• 版本 / 分支: master，阶段 3 实现提交 29df994
• 环境: Windows + EasyX + Routed 键盘生产路径
• 发现人: 用户 KEY1 人工回归
• 关联 Fix ID: Fix-BUG-20261009-0001

问题描述

• 现象: Tab 把逻辑焦点移入 Table 的分页 Button 后，焦点框不会立即出现；焦点离开后，旧焦点框也不会立即消失。只有 hover、翻页或其它原因再次触发表格重绘时，屏幕才与逻辑焦点状态一致。
• 影响范围: Table 内部上一页/下一页 Button 的全部逻辑焦点视觉；逻辑焦点身份和 Tab 顺序本身正确。
• 期望结果: 分页 Button 获焦和失焦都必须在当前输入批次的托管重绘收口中刷新整张 Table，不依赖下一次无关事件。

复现信息

• 前置条件: Table 已首次绘制并 materialize 分页 Button，当前页存在可用分页方向。
• 复现步骤:

1. 启动 KEY1。
2. 使用 Tab 把焦点移动到 Table 分页 Button。
3. 不移动鼠标、不触发其它控件，观察分页区。
4. 再按 Tab 离开分页 Button，继续观察分页区。

• 复现概率：人工回归稳定观察到
• 人工证据: 用户于 2026-10-09 的 KEY1 回归描述。

根因分析

• Table 分页 Button 是真实 Button，但它属于 Table 内部绘制单元，不能作为独立顶层重绘 root 提交。
• Button::applyFocusState() 只把内部 Button 自身标脏并请求重绘；Table 没有因此进入 dirty，外层 Canvas 的脏子树判断看不到需要重画的 Table。
• 逻辑焦点状态已更新，但屏幕继续保留上一帧，直到后续事件把 Table 自身标脏。

跟踪信息

• 首次发现时间: 2026-10-09
• 最后更新时间: 2026-10-09
• 修复版本: 29df994
• 验证版本: Debug x64 定向 focus UI 3/3、完整 UI 1/1、四配置 67/67 与 KEY1–KEY6 编译通过
• 关联记录: Module-20261009-0007

关闭边界

• 自动像素测试已证明分页 Button 焦点框在 Tab 进入时即时出现、离开时即时清除。
• BUG 最终人工关闭仍需用户复验 KEY1；自动通过不替代该人工门槛。