Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SetHwndPropStr

IAccPropServices::SetHwndPropStr method

This method wraps SetPropValue, providing a more convenient entry point for callers who are annotating HWND-based accessible elements.

Syntax


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

Parameters

hwnd [in]

Type: HWND

Identifies the accessible element that is to be annotated. This replaces the identity string.

idObject [in]

Type: DWORD

Identifies the accessible element that is to be annotated. This replaces the identity string.

idChild [in]

Type: DWORD

Identifies the accessible element that is to be annotated. This replaces the identity string.

idProp [in]

Type: MSAAPROPID

Specifies which property of that element is to be annotated.

str [in]

Type: LPCWSTR

Specifies a new value for that property.

Return value

Type: HRESULT

If successful, returns S_OK.

May return other error codes under exceptional error conditions such as low memory.

Remarks

By using this method, the caller does not have to obtain an identity string; it can specify the hwnd, idObject, and idChild parameters directly.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98

Header

Oleacc.h (include OleAcc.h Include Initguid.h first.)

DLL

Oleacc.dll

See also

IAccPropServices
ClearHwndProps
SetHwndProp
SetHwndPropServer
SetPropValue

 

 

Community Additions

ADD
Show:
© 2015 Microsoft