ebbf9e1335
1) 新增「选中行/焦点行」语法,控件监控新增列表信息
- XPath 快照新增状态属性:@IsSelected / @IsFocused / @IsOffscreen / @IsEnabled
例如 /Window[1]//DataGrid[@AutomationId='x']/DataItem[@IsSelected='true']
- IsSelected 随控件树一起从缓存读(SelectionItemPattern);对只在容器上暴露
SelectionPattern 的提供者(实测 WinForms ListView/DataGridView),树读完后
由容器反推每个子项的选中状态,@IsSelected 与「选中状态」取值因此可用
- 新增取值键:列表行数 / 列表列数 / 列表选中项数(Grid → Table → Selection)
- 控件属性新增「列表概况」(行×列 + 选中项数 + 首项文本)
2) 拾取时显示层级:蓝框=光标所在窗口,黄框=向上遍历的控件链
- PointPickResult 增加 HierarchyFrames;TargetProbeService 填蓝色窗口层 +
UiAutomationService.DescribeAncestorFrames 产出的黄色控件链(最多 6 层)
- 新增 UI/PickHierarchyOverlayForm:跟随锚点窗口、只读 GetWindowRect、
最小化/关闭即收起、置顶不抢焦点、点击穿透
- CrosshairPicker 预览改用层级框;只有 Win32/MSAA 信息时退回原来的单框高亮
3) 控件属性按 UIA/Win32 分类补全(没有的就新增)
- UIA:父元素、RawView/ControlView/ContentView 子元素数、RangeValue、
Toggle 状态、选中情况、列表概况(全部按需读取,选中节点时才跨进程)
- Win32:样式 GWL_STYLE、扩展样式 GWL_EXSTYLE、启用、最大化、层级关系
(父窗口 / 直接子窗口数 / 同类序号)
- GetWindowStyle 原本读的其实是 GWL_EXSTYLE,已正名为 GetWindowExStyle,
GWL_STYLE 用新方法读取
实测(跨进程,目标为夹具/记事本):
- 夹具列表选中第 2 行:DataItem[2] IsSelected=True;@IsSelected='true' 唯一命中并
取到「项目 2」;列表行数=3、列表列数=2、列表选中项数=1
- 拾取夹具列表行:7 层框(1 蓝窗口 + 6 黄控件链),覆盖层实际绘制并截图确认
- 记事本文档:控件属性显示 文本内容="agfa\r\raaaaa"(Name 是「文本编辑器」)
回归 29/29 通过
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