Files
StellarX-kaifa/开发记录/功能变更/Feature-20260409-0006-窗口最大化收口保护调整.md
T
2026-04-09 04:19:56 +08:00

55 lines
1.4 KiB
Markdown

# Feature-20260409-0006
> 适用场景:记录小到中等规模的接口、行为、默认值、交互和内部机制变化。
## 基本信息
- ID: `Feature-20260409-0006`
- 标题: 窗口最大化收口保护从跨度阈值改为非法尺寸判断
- 类型:修改
- 级别:L2
- 模块:Window / Resize
- 状态:已完成 / 待用户回归
- 关联:
- `BUG-20260409-0003`
- `Fix-BUG-20260409-0003`
## 背景
- 旧实现把“大跨度尺寸变化”视为异常帧。
- 在初始窗口较小、显示器较大时,正常最大化会被误伤。
## 变更内容
- 删除旧的跨度保护语义:
- 不再以 `abs(finalW - width)``abs(finalH - height)` 决定是否跳过。
- 新增非法尺寸保护语义:
- 仅拦截 `<= 0` 的客户区尺寸
- 仅拦截明显超出虚拟桌面合理范围的客户区尺寸
- 新增两类调试日志:
- 非法尺寸跳过日志
- 大跨度但继续执行日志
## 对外影响
- 直接最大化的行为更稳定。
- 之前会黑背景/残影的场景,现在理论上应恢复为正常收口。
## 兼容性
- 向后兼容。
- 不涉及公开 API 变化。
## 验证方式
- 用户回归 `KEY == 1 ~ 4`
- 日志检查是否继续打印 `尺寸调整已完成`
- 单文件编译验证 `Window.cpp`
## 落地信息
- 涉及文件:
- `Window.cpp`
- 落地状态:
- 当前工作区已完成,待提交