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 |