选中行/焦点行语法、列表信息键、拾取层级框、控件属性补全
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:
@@ -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** 开始:
|
||||
|
||||
@@ -49,6 +49,7 @@ MainForm(UI/MainForm.cs) 三栏主界面:窗口列表 | 控件树/列
|
||||
| 主界面布局/按钮/三栏比例 | `UI/MainForm.cs` | 布局自检 `VerifyLayout()` 会报错,改动后看日志 |
|
||||
| 控件树怎么显示、要不要闪烁 | `UI/ControlTreeReconciler.cs` | 增量更新,绝不清空重建 |
|
||||
| 拾取为什么选到容器 | `Services/UiAutomationService.cs` 的 `FromHandleAtPoint` | 命中后向深处收敛 |
|
||||
| 拾取的蓝框/黄框(层级) | `Services/TargetProbeService.cs`(FillHierarchyFrames)+ `UI/PickHierarchyOverlayForm.cs` | 蓝=光标所在窗口,黄=向上遍历的控件链 |
|
||||
| 控件树读取来源与顺序 | `Services/ControlTreeService.cs` | Auto = UIA → MSAA → Win32 |
|
||||
| UIA 快照/缓存/Pattern | `Services/UiAutomationService.cs` | 统一 RawView + CacheRequest |
|
||||
| 列表读取(行列/单元格/降级) | `Services/ListReaderService.cs` | 最长的文件,见其顶部导览 |
|
||||
|
||||
Reference in New Issue
Block a user