IAccPropServices::SetHmenuPropStr method (oleacc.h)

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

Syntax

HRESULT SetHmenuPropStr(
  [in] HMENU      hmenu,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] LPCWSTR    str
);

Parameters

[in] hmenu

Type: HMENU

Identifies the HMENU-based accessible element to be annotated.

[in] idChild

Type: DWORD

Specifies the child ID of the accessible element.

[in] idProp

Type: MSAAPROPID

Specifies which property of the accessible element is to be annotated.

[in] str

Type: LPCWSTR

Specifies a new value for the idProp 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 hmenu, idObject, and idChild parameters directly.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header oleacc.h (include OleAcc.h Include Initguid.h first.)
DLL Oleacc.dll
Redistributable Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98

See also

ClearHmenuProps

IAccPropServices

SetHmenuProp

SetHmenuPropServer

SetPropValue