CUIAInspector：一个拿来即用的 UIA 组件检查C++类

前言

写 Windows 自动化的时候，经常要和 UIAutomation 打交道。获取组件信息、遍历控件树、查找特定元素，这些操作每次都要写一堆 COM 调用和属性获取代码，重复又容易出错。

干脆封装了一个类，把常用的能力都塞进去，以后直接拿来用。内部处理了线程安全、双编码输出、智能文本获取这些细节，外部只需要调用几个方法就行。

效果图：

能做什么

1. 鼠标取词 —— 获取鼠标下组件的信息

把鼠标指到哪，就能拿到那个组件的类型、文本、坐标、状态等完整信息。

2. 遍历窗口组件树 —— 拿到一个窗口下所有控件

给一个窗口句柄，递归遍历所有子组件，返回完整列表。每个组件都带 depth 层级信息，可以还原整个控件树结构。支持 RawView（所有元素）和 ControlView（仅控件）两种模式。

3. 追溯组件层级 —— 从某个组件一路找到顶层

从鼠标下的组件开始，向上遍历所有父级，直到顶层窗口。调试布局、分析组件嵌套关系时很有用。

4. 获取焦点组件

直接拿到当前键盘焦点所在的组件信息。

5. 智能文本获取

自动从 TextPattern、ValuePattern、LegacyIAccessiblePattern、Name 等多个来源尝试获取文本，保证尽量拿到内容而不是空字符串。

6. 双编码输出

同时提供 Unicode（W版）和 UTF-8（A版）接口，新老工程都能直接用，不用管编码转换。

7. 线程安全

内置临界区保护，多线程环境下可以放心调用。

感谢您的来访，获取更多精彩文章请收藏本站。