Codex
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# BUG-20260410-0004
|
|
|
|
> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
|
|
|
|
## 基本信息
|
|
|
|
- ID: `BUG-20260410-0004`
|
|
- 标题: 按钮 Tooltip 显示后，鼠标移出按钮区域提示框不消失
|
|
- 状态：已修复
|
|
- 严重性：S3
|
|
- 优先级：P1
|
|
- 模块: Button / Tooltip / 托管重绘
|
|
- 版本 / 分支: 当前工作区 / 下一版本开发中
|
|
- 环境: Windows + EasyX，本地 GUI Demo
|
|
- 发现人: 用户
|
|
- 关联 Fix ID: `Fix-BUG-20260410-0004`
|
|
|
|
## 问题描述
|
|
|
|
- 现象:
|
|
- 按钮启用 Tooltip 后，提示框成功显示。
|
|
- 鼠标离开按钮区域后，Tooltip 仍残留在屏幕上，不会及时消失。
|
|
- 影响范围:
|
|
- 所有启用了 Tooltip 的 `Button`
|
|
- 典型场景包括 `KEY == 4` 的综合回归用例
|
|
- 期望结果:
|
|
- 鼠标离开按钮后，Tooltip 应立即回贴并消失，不留下残影
|
|
- 实际结果:
|
|
- Tooltip 逻辑状态已切换为隐藏，但屏幕上的提示框区域未被及时擦除
|
|
|
|
## 复现信息
|
|
|
|
- 前置条件:
|
|
- 使用启用 Tooltip 的按钮
|
|
- 复现步骤:
|
|
|
|
1. 运行带 Tooltip 按钮的 Demo
|
|
2. 将鼠标悬停在按钮上，等待 Tooltip 显示
|
|
3. 将鼠标移出按钮区域，观察 Tooltip 是否立即消失
|
|
|
|
- 复现概率：高概率
|
|
- 最小复现 Demo:
|
|
- `z-testDome.cpp` 中 `KEY == 4`
|
|
- 证据：现象观察 + 代码链路分析
|
|
|
|
## 初步分析
|
|
|
|
- 疑似位置:
|
|
- [`Button.cpp`](D:/programming/imGUI-easyX/imGui-easyX/Button.cpp)
|
|
- `Button::hideTooltip()`
|
|
- 触发条件:
|
|
- Tooltip 已经显示
|
|
- 鼠标离开按钮，进入 Tooltip 隐藏分支
|
|
- 相关线索:
|
|
- Tooltip 不是独立控件树成员，而是 `Button::draw()` 末尾补画的内置浮层
|
|
- 隐藏时若只作废快照而不回贴 Tooltip 自己的背景，按钮本体重绘并不会覆盖 Tooltip 占用区域
|
|
- 最近相关改动:
|
|
- 事件改状态 / Window 托管重绘收口
|
|
- 布局系统第一阶段重构
|
|
|
|
## 跟踪信息
|
|
|
|
- 首次发现时间: 2026-04-10
|
|
- 最后更新时间: 2026-04-10
|
|
- 修复版本: 待定
|
|
- 验证版本: 当前工作区
|
|
- 备注:
|
|
- 本文档仅记录问题本身，具体修复方案见关联 Fix 文档
|