UiaProviderForNonClient 函数 (uiautomationcoreapi.h)

获取窗口的整个非工作区的提供程序,或窗口非工作区中的控件的提供程序。

语法

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

参数

[in] hwnd

类型: HWND

拥有非工作区或非客户端控件的窗口。

[in] idObject

类型: long

非客户端控件的对象标识符,或整个非工作区 的OBJID_WINDOW 。 有关可能值的列表,请参阅 对象标识符

[in] idChild

类型: long

非客户端控件的子标识符。

[out] ppProvider

类型: IRawElementProviderSimple**

接收非工作区或非客户端控件的提供程序。

返回值

类型: HRESULT

如果成功,则返回S_OK,否则返回错误值。

注解

此函数返回窗口非工作区的默认 Microsoft UI 自动化提供程序。 UI 自动化支持非工作区,而无需窗口中的任何显式帮助。 可以使用此函数检索的 IRawElementProviderSimple 接口替代和自定义支持。

将此函数与 ProviderOptions_RefuseNonClientSupport 标志一起使用时特别有用,该标志禁用非工作区UI 自动化默认提供程序,以便窗口可以提供自己的提供程序。

非工作区中控件支持的对象 ID 包括OBJID_WINDOW、OBJID_VSCROLL、OBJID_HSCROLLOBJID_TITLEBAROBJID_MENUOBJID_SIZEGRIP 对于 OBJID_TITLEBAR,请使用子 ID 来区分整个标题栏及其包含的按钮。

要求

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

另请参阅

提供程序的函数