无障碍(UIA)
- 由
ZufyUIWindowTool.h提供 UI Automation 提供程序;元素侧 API 见「元素基类」。 - 窗口侧:
SetAccessibilityEnabled(bool)(默认开)、FocusElement、GetFocused/Hovered/PressedElement。
易错
- 库不存历史、不读写文件,提供程序只反映当前帧。
WM_GETOBJECT仅在开启时处理。
调试 / 自动化通道
inline void SetDebugEnabled(bool); inline bool IsDebugEnabled();
- 默认关闭;开启后目标窗口处理
WM_COPYDATA(dwData= 命令号,回包0x5A554631)。 - 命令集(1..23):
| 命令 | 作用 | 命令 | 作用 |
|---|---|---|---|
| 1 | Ping | 12 | ClearHighlight |
| 2 | ListWindows | 13 | GetErrors(统一日志 E/W/I/D,≤500) |
| 3 | GetFrameStats | 14 | ClearErrors |
| 4 | GetElementTree | 15/16/17 | TopN 重绘/布局/缓存(all=全部) |
| 5 | ForceRepaint | 18 | TopN 绘制 |
| 6 | SetElementText("id\ttext") | 19 | ResetCounters |
| 7 | InvokeElement | 20 | SetVisible("id\t0/1") |
| 8 | FocusElement | 21 | SetMargin("id\tx\ty") |
| 9 | GetElementInfo | 22 | SetHighlightColor("RRGGBB") |
| 10 | GetElementAt("x,y" 屏幕→AutomationId) | — | — |
| 11 | Highlight(id) | 23 | GetTheme(主题名 + 各 Role 的 AARRGGBB) |
- 统一日志:
detail::Log(level, tag, msg)、LogWarning/LogInfo/DebugLog、RecordError(→ E 级并触发UIZSignals::Error)。
易错
- 调试器侧发命令要带超时(
SendMessageTimeout,不加SMTO_BLOCK),否则目标忙时会卡死调试器。ZUFYUI_DEBUG是编译期开关(日志),SetDebugEnabled是运行期开关(通道/统计)——两套语义别混。