完善 XPath 定位与控件监控体验

- 增加简明到深入的 XPath 定位教程
- 保留增量控件树刷新与可编辑 Path
- 完善悬浮条条件选择和诊断

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
zimoyin
2026-10-13 13:00:10 +08:00
parent ec785c4fb6
commit f31b50bb36
51 changed files with 8491 additions and 1931 deletions
+61
View File
@@ -0,0 +1,61 @@
# tests —— 可运行的测试夹具
真实 PACS/OCS 客户端要么不暴露 UIA(CEF 套壳),要么树太大没法人工核对。
这里放一个**普通 WinForms 窗口**,控件类型、名称、层级都是已知的,用来验证本工具的读取链路。
## 运行
```bat
tests\run-fixture.cmd :: Debug(默认)
tests\run-fixture.cmd Release :: Release
```
脚本会先用 `dotnet msbuild`(没有 dotnet 时用 `msbuild`)构建 `tests/uia-fixture`,
然后启动 `UiaFixture.exe`。也可以直接在 Rider / VS 里打开 `pacs_win_uia.sln` 单独运行这个项目。
## 窗口内容
| 窗口 | 内容 |
| --- | --- |
| `UIA 测试夹具` | 「控件」页:按钮、文本框、复选框、单选、下拉、两列 ListView、TreeView、状态标签;「表格」页:5 行 × 3 列 DataGridView;「嵌套」页:三层嵌套容器里的 ListBox |
| `UIA 测试夹具 - 第二个窗口` | 一个按钮(测试"选哪个窗口"、窗口列表分组与匹配) |
两个窗口的**标题与类名都固定**,所以保存的监控条目、悬浮条显示条件可以长期复用。
## 建议的验证清单
1. **控件树**:选中 `UIA 测试夹具` → 期望读到 Button/Edit/CheckBox/ComboBox/List/Tree 等节点,
「控件属性」里能看到控件Path、页面特征、焦点状态。
2. **拾取**:拾取「测试按钮」,期望拾取后控件树**以顶层窗口为根**展开并选中该按钮
(与窗口列表选中同一窗口得到的树一致),高亮框在拾取结束后消失。
2. **列表读取**:选中 DataGridView → 期望 5 行 × 3 列;ListView 走 MSAA/Win32 也应能读到行。
3. **path 往返**:在控件树里选中任意节点 → 复制「控件属性 → 控件Path」→ 杂项 →「按 path 定位…」→ 粘贴 → 定位,
期望命中同一个控件并在树上选中(这是"复制的 path 能不能用"的回归测试)。
4. **按 path 定位(故意写错)**:把路径中间一段改成不存在的名字,期望明确报出**第几段**没匹配,
而不是高亮到名字相同的另一个控件。
5. **监控列表**:添加一条指向「FixtureButton」的条目 → 点击该行立即出现红框、控件树展开到它;
点击标题、文本框、复选框那几行同样要有反应(点击任何位置都定位)。
6. **绘制所有控件框**:杂项 →「绘制所有控件框」,期望窗口里每个控件都套上一个细红框,
拖动/最小化目标窗口时框跟随/隐藏。
7. **命令与退出**:设置里加一条 `启动` 命令 `start "" notepad.exe`(测试用),退出工具后期望该进程被结束。
8. **拾取不触发目标**:拾取夹具窗口里的「测试按钮」时,期望按钮**不会被按下**(状态标签不变化,
见「控件」页右下角的状态文字),也不会抢走焦点。
> 注意:夹具只是测试目标,不要在里面放真实患者数据。
## 路径与持久化回归测试
`regression/RegressionTests.csproj` 是独立的 net48 console 测试工程。它引用主项目,在纯内存 `ControlTreeNode` 快照上覆盖 XPath、重复身份、转义、全节点 roundtrip、唯一性与不完整树;验证所有祖先 Name 改变后生成路径仍有效、稳定祖先锚定,以及 MSAA/Win32 来源不丢失。旧格式测试现在要求明确拒绝执行,旧文件仅保留用于人工编辑;保存前必须修正为 XPath。另验证动态字段不持久化、缺失刷新间隔默认300ms、悬浮条缺省启用值和显式停用值的区别,以及悬浮条窗口条件的严格匹配。测试不访问自身 UIA 或真实业务窗口。
新一轮界面验收:
- 静置控件树不应不断清空/重绘;更改目标控件文字只更新该节点;展开状态、选中和滚动保持。
- 双击监控 Path 打开多行编辑器;取消不改变配置,非法 XPath 不允许提交;编辑过程中不自动跳去定位。
- 悬浮条进程/类名/标题可以输入和下拉选择;导入 XPath 后使用“检测显示条件”核对不显示原因。
- Name 变化的定位方案见 `docs/XPath定位.md`。
在仓库根目录执行:
```bat
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug -v:minimal
tests\regression\bin\Debug\RegressionTests.exe
```