IAccPropServer::GetPropValue 方法 (oleacc.h)
检索可访问元素的属性值。
语法
HRESULT GetPropValue(
[in] const BYTE *pIDString,
[in] DWORD dwIDStringLen,
[in] MSAAPROPID idProp,
[out] VARIANT *pvarValue,
[out] BOOL *pfHasProp
);
参数
[in] pIDString
类型: const BYTE*
包含一个标识所请求的属性的字符串。
[in] dwIDStringLen
类型: DWORD
指定由 pIDString 参数指定的标识字符串的长度。
[in] idProp
类型: MSAAPROPID
指定一个 GUID,它指示所需的属性。
[out] pvarValue
类型: VARIANT*
指定重写属性的值。 仅当 pfHasProp 为 TRUE 时,此参数才有效。 如果 pfHasProp 设置为 FALSE,则服务器必须将此设置为 VT_EMPTY。
[out] pfHasProp
类型: BOOL*
指示服务器是否为请求的属性提供值。 如果服务器返回重写属性,则应将其设置为 TRUE ;如果未返回属性 (则服务器应将其设置为 FALSE ,在这种情况下,服务器还应将 pvarValue 设置为 VT_EMPTY) 。
返回值
类型: HRESULT
返回S_OK,但在内存不足等异常错误条件下除外。 如果未重写指定的属性,则 pfHasProp 应设置为 FALSE,pvarValue 应设置为服务器VT_EMPTY。
注解
如果注册了单个回调对象来批注多个可访问元素,则标识字符串可用于确定此请求引用的元素。
如果可访问元素是基于 HWND 的,则可以使用 IAccPropServices::D ecomposeHwndIdentityString 从标识字符串中提取 HWND/idObject/idChild。
如果回调具有要为指定属性返回的值,则应在 pvarValue 中返回它,并将 pfHasProp 设置为 TRUE。 否则,它应将 pvarValue 设置为 VT_EMPTY,并将 pfHasProp 设置为 FALSE。 在后一种情况下,原始 IAccessible 接口指针将用于获取此属性的值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista 或 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 |