IAccPropServices::SetHwndPropStr 方法 (oleacc.h)

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

语法

HRESULT SetHwndPropStr(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] LPCWSTR    str
);

参数

[in] hwnd

类型: HWND

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

[in] idObject

类型: DWORD

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

[in] idChild

类型: DWORD

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

[in] idProp

类型: MSAAPROPID

指定要批注该元素的哪个属性。

[in] str

类型: LPCWSTR

为属性指定一个新值。

返回值

类型: HRESULT

如果成功,则返回 S_OK。

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

注解

通过使用此方法,调用方不必获取标识字符串;它可以直接指定 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

SetHwndPropServer

SetPropValue