IRawElementProviderSimple::get_HostRawElementProvider 方法 (uiautomationcore.h)

指定此元素的主机提供程序。

此属性为只读。

语法

HRESULT get_HostRawElementProvider(
  IRawElementProviderSimple **pRetVal
);

参数

pRetVal

返回值

备注

此属性通常是自定义控件窗口的 Microsoft UI 自动化提供程序。 UI 自动化将此提供程序与自定义提供程序结合使用。 例如,元素的运行时标识符通常从主机提供程序获取。

在以下情况下,必须返回主机提供程序:当元素是片段根时,当元素是简单元素 ((例如) 按钮)时,以及当提供程序是重新定位占位符 (时,有关详细信息,请参阅 提供程序重新定位) 。 在其他情况下, 属性应为 NULL

示例

以下示例返回承载此提供程序所服务的控件的窗口的主机提供程序。

HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
    return UiaHostProviderFromHwnd(controlHWnd, pRetVal); 
}
            

要求

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

另请参阅

IRawElementProviderSimple

UiaHostProviderFromHwnd