控件属性显示内容文本;拾取命中容器时向深处收敛

用户反馈两点:

1) 控件属性里也要看到内容(输入框/富文本/多行编辑器的正文)
   - UiaElementInfo 新增只读展示字段「文本内容」(不序列化,选中节点时现算)
   - 与取值键「文本内容」同源:Value → Text → Name
   - 实测(真实 Windows 11 记事本文档节点):
     文本内容="agfa\r\raaaaa",Name="文本编辑器"(通用标题)
     ControlPath=/Window[1]/Pane[@ClassName='NotepadTextBox']/Document[@ClassName='RichEditD2DPT']

2) 拾取不能正确识别(实测:记事本正文拾取到 Pane[NotepadTextBox] 而不是里面的
   Document[RichEditD2DPT])
   - 根因:提供者的命中测试经常先返回"容器",代码直接接受了它
   - FromHandleAtPoint 命中后新增 RefineHitAtPoint:在命中元素内部继续往
     "包含光标的最深/最小元素"收敛(有界:节点数/深度/3 秒)
   - MainForm 的"只拿到窗口再重探一次"扩展到"只拿到容器(Window/Pane/Group/Custom)
     也重探一次":无障碍树按需生成的客户端第一次通常只给容器,600ms 后第二次才给到叶子

实测(真实记事本窗口内 49 个采样点):
  42 × ControlType.Document / RichEditD2DPT(正文),其余为工具栏按钮/输入法宿主
  修复前同一组采样中正文区域会命中 Pane

回归 27/27 通过
This commit is contained in:
zimoyin
2026-10-13 16:41:56 +08:00
parent 69d69b351a
commit d7e50675f0
4 changed files with 64 additions and 6 deletions
+2
View File
@@ -48,6 +48,7 @@ MainForm(UI/MainForm.cs) 三栏主界面:窗口列表 | 控件树/列
|---|---|---|
| 主界面布局/按钮/三栏比例 | `UI/MainForm.cs` | 布局自检 `VerifyLayout()` 会报错,改动后看日志 |
| 控件树怎么显示、要不要闪烁 | `UI/ControlTreeReconciler.cs` | 增量更新,绝不清空重建 |
| 拾取为什么选到容器 | `Services/UiAutomationService.cs` 的 `FromHandleAtPoint` | 命中后向深处收敛 |
| 控件树读取来源与顺序 | `Services/ControlTreeService.cs` | Auto = UIA → MSAA → Win32 |
| UIA 快照/缓存/Pattern | `Services/UiAutomationService.cs` | 统一 RawView + CacheRequest |
| 列表读取(行列/单元格/降级) | `Services/ListReaderService.cs` | 最长的文件,见其顶部导览 |
@@ -81,6 +82,7 @@ MainForm(UI/MainForm.cs) 三栏主界面:窗口列表 | 控件树/列
- **不要"取第一个匹配"**:不确定就报错,让人重新拾取。
- **PropertyGrid 正在编辑时不要去 rebind**:会打断用户输入,`MainForm` 里有专门判断。
- **悬浮条的"名称"不是定位条件**:定位条件是进程名/窗口类/标题关键词 + 可选导入 XPath。
- **拾取到"容器"要往深处收敛**:提供者的命中测试经常先给容器(实测 Windows 11 记事本正文返回 `Pane[NotepadTextBox]`),拾取会在命中后往下找"包含光标的更深控件",并且只拿到容器时会在 600ms 后自动重探一次。改这块看 `UiAutomationService.FromHandleAtPoint` 与 `MainForm.ScheduleDeeperPickRetry`。
- **输入框/富文本的内容常常不在 `Name` 里**:WinForms 文本框的 `Name` 就是内容,但 WinForms 富文本、Chromium/CEF、UWP 文本框的 `Name` 可能是通用标题(例如 `RichEdit Control`),内容只在 `Value`/`Text` 模式里。取内容请用跨来源键 **`文本内容`**(顺序 Value → Text → Name,MSAA 侧 = accValue → accName,Win32 侧 = 窗口标题);新增/拾取控件时它已经是默认的 valueKey。
- **旧路径格式已停用**:`[Uia] A[id] > B:name`、`Type[id]` 之类不再执行,只保留给人工编辑修正。
- **本工具自己的窗口不算遮挡**:主界面/设置窗口压住目标不影响悬浮条显示(否则在设置页里根本测不了)。