IRawElementProviderHwndOverride：：GetOverrideProviderForHwnd 方法 (uiautomationcore.h)

  • 项目

获取指定元素的UI 自动化提供程序。

语法

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

参数

[in] hwnd

类型： HWND

元素的窗口句柄。

[out, retval] pRetVal

类型： IRawElementProviderSimple**

接收指向指定窗口的新提供程序的指针;如果未重写提供程序，则为 NULL 。 此参数未经初始化即被传递。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

此方法由包含基于窗口的子元素的片段根实现。 默认情况下，除了任何自定义提供程序之外，Windows 中托管的控件还由默认提供程序提供服务。 默认提供程序将父窗口中的所有窗口视为同级窗口。 如果要重构UI 自动化树，使一个基于窗口的控件被视为另一个控件的子控件，则必须通过在片段根上实现此方法来替代默认提供程序。 返回的提供程序可以提供指定组件的其他属性或替代属性。

返回的提供程序必须是片段树的一部分。 它可以提供指定组件的其他属性或替代属性。

如果返回的提供程序实现 IRawElementProviderFragment，则提供程序应是片段树的一部分，并且可以通过从片段的根目录导航来访问。

要求

要求 值
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

另请参阅

IRawElementProviderHwndOverride