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_HSCROLL、OBJID_TITLEBAR、OBJID_MENU和OBJID_SIZEGRIP。 对于 OBJID_TITLEBAR，请使用子 ID 来区分整个标题栏及其包含的按钮。

要求

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

另请参阅

提供程序的函数