UiaProviderFromIAccessible 函数 (uiautomationcoreapi.h)

基于指定的 Microsoft Active Accessibility 对象创建 Microsoft UI 自动化提供程序。

语法

HRESULT UiaProviderFromIAccessible(
  [in]  IAccessible               *pAccessible,
  [in]  long                      idChild,
  [in]  DWORD                     dwFlags,
  [out] IRawElementProviderSimple **ppProvider
);

参数

[in] pAccessible

类型: IAccessible*

指向 Microsoft Active Accessibility 对象的指针。

[in] idChild

类型: long

Microsoft Active Accessibility 对象的子 ID。

[in] dwFlags

类型:DWORD

以下值之一:

UIA_PFIA_DEFAULT

UIA_PFIA_UNWRAP_BRIDGE

[out] ppProvider

类型: IRawElementProviderSimple**

新的 UI 自动化提供程序。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

UI 自动化通过为 Microsoft Active Accessibility 提供程序提供代理(称为 MICROSOFT Active Accessibility 到 UI 自动化代理)来为它们提供向后兼容性。 当窗口通过返回 Microsoft Active Accessibility 提供程序响应 WM_GETOBJECT 消息时,会自动创建此代理。 需要手动创建 MICROSOFT Active Accessibility to UI Automation 代理时,请使用 UiaProviderFromIAccessible ;例如,在实现 IAccessibleEx 接口时。

某些属性(如 LabeledBy)必须表示为 UI 自动化提供程序。 IAccessibleEx 提供程序可以使用 UiaProviderFromIAccessible 包装 IAccessible 对象,以将其作为 LabeledBy 属性的值返回。

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 uiautomationcoreapi.h
Library Uiautomationcore.lib
DLL Uiautomationcore.dll

另请参阅

提供程序的函数

UiaIAccessibleFromProvider