IUIAutomation 接口 (uiautomationclient.h)

公开使 Microsoft UI 自动化客户端应用程序能够发现、访问和筛选UI 自动化元素的方法。 UI 自动化将UI 自动化的每个元素公开为由 IUIAutomation 接口表示的对象。 此接口的成员不特定于特定元素。

继承

IUIAutomation 接口继承自 IUnknown 接口。 IUIAutomation 还具有以下类型的成员：

方法

IUIAutomation 接口具有这些方法。

IUIAutomation：：AddAutomationEventHandler 注册处理 Microsoft UI 自动化事件的方法。注意 在实现事件处理程序之前，应熟悉了解线程问题中所述的线程问题。
IUIAutomation：：AddFocusChangedEventHandler 注册处理焦点更改事件的方法。注意 在实现事件处理程序之前，应熟悉了解线程问题中所述的线程问题。
IUIAutomation：：AddPropertyChangedEventHandler 注册处理属性更改事件和数组的方法。
IUIAutomation：：AddPropertyChangedEventHandlerNativeArray 注册处理属性更改事件的本机数组的方法。
IUIAutomation：：AddStructureChangedEventHandler 注册处理结构更改事件的方法。注意 在实现事件处理程序之前，应熟悉了解线程问题中所述的线程问题。
IUIAutomation：：CheckNotSupported 检查提供的 VARIANT 以查看它是否包含“不支持”标识符。
IUIAutomation：：CompareElements 比较两个UI 自动化元素以确定它们是否表示相同的基础 UI 元素。
IUIAutomation：：CompareRuntimeIds 比较包含运行时标识符的两个整数数组 (ID) ，以确定其内容是否相同且属于同一 UI 元素。
IUIAutomation：：CreateAndCondition 创建一个条件，该条件选择同时匹配两个条件的元素。
IUIAutomation：：CreateAndConditionFromArray 创建一个条件，该条件基于多个条件选择元素，所有这些条件都必须为 true。
IUIAutomation：：CreateAndConditionFromNativeArray 创建一个条件，该条件基于必须全部为 true 的多个条件从本机数组中选择元素。
IUIAutomation：：CreateCacheRequest 创建缓存请求。
IUIAutomation：：CreateFalseCondition 创建始终为 false 的条件。
IUIAutomation：：CreateNotCondition 创建一个条件，该条件是指定条件的负数。
IUIAutomation：：CreateOrCondition 如果任一条件为 true，则创建存在匹配项的两个条件的组合。
IUIAutomation：：CreateOrConditionFromArray 创建两个或更多条件的组合，其中存在匹配项（如果任一条件为 true）。
IUIAutomation：：CreateOrConditionFromNativeArray 创建两个或更多条件的组合，其中存在匹配项（如果任一条件为 true）。
IUIAutomation：：CreatePropertyCondition 创建一个条件，该条件选择具有具有指定值的属性的元素。
IUIAutomation：：CreatePropertyConditionEx 创建一个条件，该条件使用可选标志选择具有指定值的属性的元素。
IUIAutomation：：CreateProxyFactoryEntry 创建代理工厂对象的新实例。
IUIAutomation：：CreateTreeWalker 检索可用于遍历 Microsoft UI 自动化树的树演练器对象。
IUIAutomation：：CreateTrueCondition 检索选择所有元素的预定义条件。
IUIAutomation：：ElementFromHandle 检索指定窗口的UI 自动化元素。
IUIAutomation：：ElementFromHandleBuildCache 检索指定窗口的UI 自动化元素，预提取请求的属性和控制模式，并将预提取的项存储在缓存中。
IUIAutomation：：ElementFromIAccessible 从 Microsoft Active Accessibility 服务器检索指定的辅助对象UI 自动化元素。
IUIAutomation：：ElementFromIAccessibleBuildCache 从 Microsoft Active Accessibility 服务器检索指定的辅助对象UI 自动化元素，预提取请求的属性和控制模式，并将预提取的项存储在缓存中。
IUIAutomation：：ElementFromPoint 检索桌面上指定点处的 UI 自动化 元素。
IUIAutomation：：ElementFromPointBuildCache 检索桌面上指定点处的 UI 自动化 元素，预提取请求的属性和控制模式，并将预提取的项存储在缓存中。
IUIAutomation：：get_ContentViewCondition 检索选择内容元素的预定义 IUIAutomationCondition 接口。
IUIAutomation：：get_ContentViewWalker 检索用于发现内容元素的 IUIAutomationTreeWalker 接口。
IUIAutomation：：get_ControlViewCondition 检索选择控件元素的预定义 IUIAutomationCondition 接口。
IUIAutomation：：get_ControlViewWalker 检索用于发现控件元素的 IUIAutomationTreeWalker 接口。
IUIAutomation：：get_ProxyFactoryMapping 检索一个 对象，该对象表示 Window 类名和关联数据到单个代理工厂的映射。
IUIAutomation：：get_RawViewCondition 检索预定义的 IUIAutomationCondition 接口，该接口选择未筛选视图中的所有 UI 元素。
IUIAutomation：：get_RawViewWalker 检索用于遍历 Microsoft UI 自动化树的未筛选视图的树演练器对象。
IUIAutomation：：get_ReservedMixedAttributeValue 检索一个静态令牌对象，该对象表示混合属性的文本属性。
IUIAutomation：：get_ReservedNotSupportedValue 检索一个静态令牌对象，该对象表示不支持的属性或文本属性。
IUIAutomation：：GetFocusedElement 检索具有输入焦点的 UI 自动化 元素。
IUIAutomation：：GetFocusedElementBuildCache 检索具有输入焦点的 UI 自动化 元素，预提取请求的属性和控制模式，并将预提取的项存储在缓存中。
IUIAutomation：：GetPatternProgrammaticName 检索控件模式的已注册编程名称。
IUIAutomation：：GetPropertyProgrammaticName 检索属性的注册编程名称。
IUIAutomation：：GetRootElement 检索表示桌面的 UI 自动化 元素。
IUIAutomation：：GetRootElementBuildCache 检索表示桌面的 UI 自动化 元素，预提取请求的属性和控制模式，并将预提取的项存储在缓存中。
IUIAutomation：：IntNativeArrayToSafeArray 将整数数组转换为 SAFEARRAY。
IUIAutomation：：IntSafeArrayToNativeArray 将 SAFEARRAY 的整数转换为数组。
IUIAutomation：:P ollForPotentialSupportedPatterns 检索在 UI 自动化 元素上可能支持的控件模式。
IUIAutomation：:P ollForPotentialSupportedProperties 检索在 UI 自动化 元素上可能支持的属性。
IUIAutomation：：RectToVariant 创建包含矩形坐标的 VARIANT。
IUIAutomation：：RemoveAllEventHandlers 删除所有已注册的 Microsoft UI 自动化 事件处理程序。
IUIAutomation：：RemoveAutomationEventHandler 删除指定的UI 自动化事件处理程序。
IUIAutomation：：RemoveFocusChangedEventHandler 删除焦点更改事件处理程序。
IUIAutomation：：RemovePropertyChangedEventHandler 删除属性更改事件处理程序。
IUIAutomation：：RemoveStructureChangedEventHandler 删除结构更改的事件处理程序。
IUIAutomation：：SafeArrayToRectNativeArray 将包含矩形坐标的 SAFEARRAY 转换为 RECT 类型的数组。
IUIAutomation：：VariantToRect 将包含矩形坐标的 VARIANT 转换为 RECT。

注解

每个UI 自动化客户端应用程序都必须获取 CUIAutomation 对象的此接口，才能访问UI 自动化的功能。

以下示例函数创建 一个 CUIAutomation 对象并获取 IUIAutomation 接口。

IUIAutomation *g_pAutomation;

BOOL InitializeUIAutomation()
{
    CoInitialize(NULL);
    HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER, 
        __uuidof(IUIAutomation), (void**)&g_pAutomation);
    return (SUCCEEDED(hr));
}

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	uiautomationclient.h (包括 UIAutomation.h)

另请参阅

客户端UI 自动化元素接口