面向 AI 智能体:本页的「阅读辅助」区块内含有与正文完全一致的原始 Markdown 源码,已去除 HTML 标签与动画特效。建议 AI 直接读取该区块,以更低的噪声快速理解内容。
## 无障碍(UIA)

- 由 `ZufyUIWindowTool.h` 提供 UI Automation 提供程序;元素侧 API 见「元素基类」。
- 窗口侧:`SetAccessibilityEnabled(bool)`(默认开)、`FocusElement`、`GetFocused/Hovered/PressedElement`。

###block_red_start
**易错**

- 库**不存历史、不读写文件**,提供程序只反映当前帧。`WM_GETOBJECT` 仅在开启时处理。
###block_red_end

## 调试 / 自动化通道

```cpp
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`)。

###block_red_start
**易错**

- 调试器侧发命令要带超时(`SendMessageTimeout`,不加 `SMTO_BLOCK`),否则目标忙时会卡死调试器。`ZUFYUI_DEBUG` 是**编译期**开关(日志),`SetDebugEnabled` 是**运行期**开关(通道/统计)——两套语义别混。
###block_red_end
第 20 章

无障碍与调试通道

UIA + SetDebugEnabled(v1.17.0)

无障碍(UIA)

易错

  • 库不存历史、不读写文件,提供程序只反映当前帧。WM_GETOBJECT 仅在开启时处理。

调试 / 自动化通道

cpp
inline void SetDebugEnabled(bool);   inline bool IsDebugEnabled();
命令 作用 命令 作用
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)

易错

  • 调试器侧发命令要带超时(SendMessageTimeout,不加 SMTO_BLOCK),否则目标忙时会卡死调试器。ZUFYUI_DEBUG 是编译期开关(日志),SetDebugEnabled 是运行期开关(通道/统计)——两套语义别混。
↑