IAccPropServices::ClearHwndProps 方法 (oleacc.h)
此方法包装 SetPropValue、 SetPropServer 和 ClearProps,并为批注基于 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。
在异常错误条件(例如内存不足)下,可能会返回其他错误代码。
有关返回值的说明,请参阅相应的 SetPropValue、 SetPropServer 或 ClearProps 方法。
注解
通过使用此方法,调用方不必获取标识字符串;它可以直接指定 hwnd、 idObject 和 idChild 参数。
此外, 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 |