给全部源码补中文注释,并新增代码导览
- 67 个 .cs 文件加中文注释:每个文件顶部说明职责/调用方/线程与节拍/ 已知限制/「要改什么就改哪里」,字段与方法逐条一行说明,复杂逻辑内插关键步骤 - 纯注释改动:脚本校验所有新增行都是注释、无非注释改动(仅 2 个文件的 BOM 随新头部注释下移,文件仍以 BOM 开头) - 新增 docs/代码导览.md:模块地图、「我要改 X 看哪个文件」对照表、易踩的坑、 悬浮条显示规则、测试与验收指引 - 编译通过,回归测试 23/23 通过 Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -1,3 +1,17 @@
|
||||
// =====================================================================================
|
||||
// WindowVisibilityTests —— 悬浮条遮挡诊断的窗口归属判断回归。
|
||||
//
|
||||
// 覆盖范围:WindowVisibility.IsOwnProcessWindow 对零句柄/本进程窗体/外部窗口的分类,
|
||||
// 以及 DescribeOccluders 生成的遮挡说明——本工具自己的窗口必须被单列为“本工具窗口/
|
||||
// 设置页自检”,外部窗口则只能被称作普通遮挡,绝不能反过来把遮挡归咎于本工具。
|
||||
//
|
||||
// 为什么这样测:只用本测试进程自建的 WinForms 窗体句柄与手工构造的 IntPtr 列表;
|
||||
// WindowEnumerationResult 天然排除本进程,所以它返回的窗口一定属于外部进程。
|
||||
// 不调用 UIA、也不操作真实目标窗口。外部窗口很可能不存在(由外部环境决定),
|
||||
// 因此相关断言在无外部窗口时会打印提示并跳过,属于预期内的“部分跳过”。
|
||||
//
|
||||
// 新增用例:加到 Register(...) 列表并实现 private static void 方法,断言走 Check.*。
|
||||
// =====================================================================================
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Windows.Forms;
|
||||
@@ -16,7 +30,9 @@ namespace PacsWinUia.RegressionTests
|
||||
{
|
||||
public static void Register(IList<KeyValuePair<string, Action>> tests)
|
||||
{
|
||||
// 防:本工具自身窗口被误判为外部遮挡窗口(或外部窗口被误判为本进程)。
|
||||
tests.Add(new KeyValuePair<string, Action>("Own-process detection classifies tool windows", OwnProcess));
|
||||
// 防:遮挡提示把外部窗口也算作本工具窗口,或本工具窗口不被单独说明。
|
||||
tests.Add(new KeyValuePair<string, Action>("Occluder message names the blocker and never blames the tool wrongly", OccluderMessages));
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user