IAccPropServices::ClearHwndProps 方法 (oleacc.h)

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

语法

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

参数

[in] hwnd

类型: HWND

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

[in] idObject

类型: DWORD

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

[in] idChild

类型: DWORD

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

[in] paProps

类型: const MSAAPROPID*

指定要重置的属性数组。 这些属性将还原为批注前的默认行为。

[in] cProps

类型: int

指定 paProps 数组中的属性数。

返回值

类型: HRESULT

如果成功,则返回S_OK,即使指定的属性从未在可访问对象上批注;清除已清除的属性被视为成功。

如果 不支持 paProps 数组中的任何属性,则返回E_INVALIDARG。

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

有关返回值的说明,请参阅相应的 SetPropValueSetPropServerClearProps 方法。

注解

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

此外, SetHwndPropStr 采用常规 Unicode 字符串作为参数;调用方不需要专门分配 BSTR

要求

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

另请参阅

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr