529f7910a1
问题:富文本(RichTextBox、Chromium/CEF、UWP 文本框)的 UIA Name 往往是通用标题 (实测夹具里是 "RichEdit Control"),真正的内容只在 ValuePattern/TextPattern 里; 而新增监控项时默认 ValueKey 是 Name,于是读回来的是标题而不是内容。 - ControlValueKeys 新增跨来源键「文本内容」:UIA 按 Value → Text → Name 顺序取, MSAA = accValue → accName,Win32 = 窗口标题;三种都取不到才报错并说明各自原因 - 新增/拾取控件时默认 ValueKey 改为「文本内容」(旧条目不受影响,仍按各自保存的键读) - 「文本内容」加进三个来源的可选键列表,监控列表下拉里能直接选 - 夹具新增多行富文本 FixtureRichText(内容只在 Value/Text 里) - 回归新增 ValueKeyTests(键表、Name 兜底、默认键),共 27/27 通过 实测(跨进程,目标为独立进程里的夹具窗口): - 文本框 文本内容="可编辑文本";富文本 文本内容="富文本第一行\r富文本第二行\r"; 按钮(无 Value/Text 模式)自动退回 Name="测试按钮" - 拾取点在两个控件上都精确命中 Edit / Document,且能在窗口树里找到同一节点 - 无界面读取端到端:2 条配置(//Document[...]、//Edit[...] + 文本内容)全部命中并取到值
6.1 KiB
6.1 KiB
tests —— 可运行的测试夹具
这些测试怎么跑、失败怎么办
本目录有两块东西,目的不同:
uia-fixture/—— 一个独立进程的真实 WinForms 窗口(UiaFixture.exe),用来让工具 跨进程做 UIA 读取/拾取/定位的人工验证。UIA 在同一进程内自读自身控件树会崩溃,所以必须 跨进程。构建并启动:tests\run-fixture.cmd(默认 Debug,可传Release)。regression/RegressionTests.csproj—— 自动化回归测试(net48 控制台程序),在纯内存快照或 本进程自建控件上跑断言,覆盖 XPath 定位、持久化/迁移、控件树增量刷新、悬浮条显示条件等。 它不用 UIA 读自身控件树(会崩溃)。
跑回归测试(不要在本目录直接 dotnet build,src 的 bin\Debug 可能被正在运行的工具进程锁定):
:: 用隔离的 OutputPath 构建,随后直接运行生成的 exe
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug ^
-p:OutputPath=%TEMP%\pacs-regression\ -v:minimal
%TEMP%\pacs-regression\RegressionTests.exe
- 退出码:
0= 全部用例通过;1= 存在失败(便于脚本/CI 判断)。 - 失败怎么办:在输出里找
FAIL <用例名>,其下会打印异常的 message(含 expected/actual)。 按用例名到regression/*Tests.cs的Register(...)里定位对应方法。下拉/刷新类用例可设 环境变量PACS_REGRESSION_SCREENSHOTS=<目录>,失败或关键步骤会自动把窗体截图写入该目录以便比对。 - 部分跳过是正常的:个别断言依赖桌面上是否存在其他进程的窗口(如遮挡诊断的外部窗口用例),
缺失时会打印
(... skipped)并跳过,不算失败。
真实 PACS/OCS 客户端要么不暴露 UIA(CEF 套壳),要么树太大没法人工核对。 这里放一个普通 WinForms 窗口,控件类型、名称、层级都是已知的,用来验证本工具的读取链路。
运行
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 测试夹具 |
「控件」页:按钮、文本框、富文本(FixtureRichText,内容只在 Value/Text 里,Name 是 "RichEdit Control")、复选框、单选、下拉、两列 ListView、TreeView、状态标签;「表格」页:5 行 × 3 列 DataGridView;「嵌套」页:三层嵌套容器里的 ListBox |
UIA 测试夹具 - 第二个窗口 |
一个按钮(测试"选哪个窗口"、窗口列表分组与匹配) |
两个窗口的标题与类名都固定,所以保存的监控条目、悬浮条显示条件可以长期复用。
建议的验证清单
- 控件树:选中
UIA 测试夹具→ 期望读到 Button/Edit/CheckBox/ComboBox/List/Tree 等节点, 「控件属性」里能看到控件Path、页面特征、焦点状态。 - 拾取:拾取「测试按钮」,期望拾取后控件树以顶层窗口为根展开并选中该按钮 (与窗口列表选中同一窗口得到的树一致),高亮框在拾取结束后消失。
- 列表读取:选中 DataGridView → 期望 5 行 × 3 列;ListView 走 MSAA/Win32 也应能读到行。
- path 往返:在控件树里选中任意节点 → 复制「控件属性 → 控件Path」→ 杂项 →「按 path 定位…」→ 粘贴 → 定位, 期望命中同一个控件并在树上选中(这是"复制的 path 能不能用"的回归测试)。
- 按 path 定位(故意写错):把路径中间一段改成不存在的名字,期望明确报出第几段没匹配, 而不是高亮到名字相同的另一个控件。
- 监控列表:添加一条指向「FixtureButton」的条目 → 点击该行立即出现红框、控件树展开到它; 点击标题、文本框、复选框那几行同样要有反应(点击任何位置都定位)。
- 绘制所有控件框:杂项 →「绘制所有控件框」,期望窗口里每个控件都套上一个细红框, 拖动/最小化目标窗口时框跟随/隐藏。
- 命令与退出:设置里加一条
启动命令start "" notepad.exe(测试用),退出工具后期望该进程被结束。 - 拾取不触发目标:拾取夹具窗口里的「测试按钮」时,期望按钮不会被按下(状态标签不变化, 见「控件」页右下角的状态文字),也不会抢走焦点。
注意:夹具只是测试目标,不要在里面放真实患者数据。
路径与持久化回归测试
regression/RegressionTests.csproj 是独立的 net48 console 测试工程。它引用主项目,在纯内存 ControlTreeNode 快照上覆盖 XPath、重复身份、转义、全节点 roundtrip、唯一性与不完整树;验证所有祖先 Name 改变后生成路径仍有效、稳定祖先锚定,以及 MSAA/Win32 来源不丢失。旧格式测试现在要求明确拒绝执行,旧文件仅保留用于人工编辑;保存前必须修正为 XPath。另验证动态字段不持久化、缺失刷新间隔默认300ms、悬浮条缺省启用值和显式停用值的区别,以及悬浮条窗口条件的严格匹配。测试不访问自身 UIA 或真实业务窗口。
新一轮界面验收:
- 静置控件树不应不断清空/重绘;更改目标控件文字只更新该节点;展开状态、选中和滚动保持。
- 双击监控 Path 打开多行编辑器;取消不改变配置,非法 XPath 不允许提交;编辑过程中不自动跳去定位。
- 悬浮条进程/类名/标题可以输入和下拉选择;导入 XPath 后使用“检测显示条件”核对不显示原因。
- Name 变化的定位方案见
docs/XPath定位.md。
在仓库根目录执行:
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug -v:minimal
tests\regression\bin\Debug\RegressionTests.exe