IAccPropServices::SetHwndPropServer 方法 (oleacc.h)

此方法包装 SetPropServer,为批注基于 HWND 的可访问元素的调用方提供方便的入口点。

语法

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

参数

[in] hwnd

类型: HWND

标识要批注的可访问元素。 这会替换标识字符串。

[in] idObject

类型: DWORD

标识要批注的可访问元素。 这会替换标识字符串。

[in] idChild

类型: DWORD

标识要批注的可访问元素。 这会替换标识字符串。

[in] paProps

类型: const MSAAPROPID*

指定要由指定回调对象处理的属性数组。

[in] cProps

类型: int

指定 paProps 数组中的属性数。

[in] pServer

类型: IAccPropServer*

指定将在客户端请求一个已重写属性时调用的回调对象。

[in] annoScope

类型: AnnoScope

可以为 ANNO_THIS,指示批注仅影响所指示的可访问元素;也可以为 ANNO_CONTAINER,指示批注应用于元素及其直接子元素。

返回值

类型: HRESULT

如果成功,则返回 S_OK。

如果 paProps 数组中的任何属性都不支持属性、标识字符串无效或 annoScope 不是ANNO_THIS或ANNO_CONTAINER之一,则返回E_INVALIDARG。

在异常错误条件(例如内存不足)下,可能会返回其他错误代码。

注解

通过使用此方法,调用方不必获取标识字符串;它可以直接指定 hwndidObjectidChild 参数。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 oleacc.h (包括 OleAcc.h Include Initguid.h first.)
DLL Oleacc.dll
可再发行组件 具有 SP6 及更高版本和 Windows 98 的 Windows NT 4.0 上的 Active Accessibility 2.0 RDK

另请参阅

ClearHwndProps

IAccPropServices

SetHwndProp

SetHwndPropStr

SetPropServer