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