选中行/焦点行语法、列表信息键、拾取层级框、控件属性补全

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 通过
This commit is contained in:
zimoyin
2026-10-13 19:19:16 +08:00
parent d7e50675f0
commit ebbf9e1335
19 changed files with 1216 additions and 6 deletions
+32
View File
@@ -196,6 +196,38 @@ XPath 中的 `Edit`、`Button` 等来自 UIA 控件类型。不同来源也会
如果控件名称是“患者编号:张三”,而“患者编号”稳定,可以使用它。
### 7b. 状态属性:选"当前选中行 / 焦点行"
节点上除了名称类属性,还有四个状态属性,值是 `'true'` / `'false'`(状态未知时不写这个属性):
| 属性 | 含义 | 来源 |
|---|---|---|
| `@IsSelected` | 是否被选中 | 行/项自己的 SelectionItemPattern,或从容器的 SelectionPattern 反推 |
| `@IsFocused` | 是否是当前焦点元素 | UIA HasKeyboardFocus |
| `@IsOffscreen` | 是否在屏幕外(被滚动出视图/折叠) | UIA IsOffscreen |
| `@IsEnabled` | 是否可用(未禁用) | UIA IsEnabled |
因此"拿当前选中行 / 焦点行"不用再写序号:
```xpath
/Window[1]//DataGrid[@AutomationId='FixtureListView']/DataItem[@IsSelected='true']
/Window[1]//DataGrid[@AutomationId='FixtureListView']/DataItem[@IsFocused='true']
```
配合取值键 `文本内容`,就能直接读到那一行的文字。注意:`@IsFocused` 取决于焦点此刻在哪个窗口;`@IsSelected` 对一次性列出选中集合的提供者(如 WinForms 列表)由容器反推得来。
### 7c. 列表信息:不用整表读取也能盯住表格
容器控件(List / DataGrid / Table / Tree)上多出三个取值键,适合放进控件监控:
| 取值键 | 含义 |
|---|---|
| `列表行数` | 行数(GridPattern 优先,其次 TablePattern) |
| `列表列数` | 列数 |
| `列表选中项数` | 当前选中项数 |
需要完整行列数据时仍然用「读取选中控件列表」。
### 8. 序号 `[n]`
序号从 **1** 开始: