Skip to content

Latest commit

 

History

History
123 lines (80 loc) · 5.21 KB

nf-oleacc-iaccpropservices-clearhwndprops.md

File metadata and controls

123 lines (80 loc) · 5.21 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:oleacc.IAccPropServices.ClearHwndProps
IAccPropServices::ClearHwndProps (oleacc.h)
This method wraps SetPropValue, SetPropServer, and ClearProps, and provides a convenient entry point for callers who are annotating HWND-based accessible elements.
ClearHwndProps
ClearHwndProps method [Windows Accessibility]
ClearHwndProps method [Windows Accessibility]
IAccPropServices interface
IAccPropServices interface [Windows Accessibility]
ClearHwndProps method
IAccPropServices.ClearHwndProps
IAccPropServices::ClearHwndProps
_msaa_IAccPropServices_ClearHwndProps
msaa.iaccpropservices_iaccpropservices__clearhwndprops
oleacc/IAccPropServices::ClearHwndProps
winauto.iaccpropservices_iaccpropservices__clearhwndprops
winauto\iaccpropservices_iaccpropservices__clearhwndprops.htm
WinAuto
7fd3f595-4897-481f-972e-04cf1a4c6046
12/05/2018
ClearHwndProps, ClearHwndProps method [Windows Accessibility], ClearHwndProps method [Windows Accessibility],IAccPropServices interface, IAccPropServices interface [Windows Accessibility],ClearHwndProps method, IAccPropServices.ClearHwndProps, IAccPropServices::ClearHwndProps, _msaa_IAccPropServices_ClearHwndProps, msaa.iaccpropservices_iaccpropservices__clearhwndprops, oleacc/IAccPropServices::ClearHwndProps, winauto.iaccpropservices_iaccpropservices__clearhwndprops
oleacc.h
OleAcc.h Include Initguid.h first.
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Oleacc.dll
Windows
Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98
19H1
IAccPropServices::ClearHwndProps
oleacc/IAccPropServices::ClearHwndProps
c++
APIRef
kbSyntax
COM
Oleacc.dll
IAccPropServices.ClearHwndProps

IAccPropServices::ClearHwndProps

-description

This method wraps SetPropValue, SetPropServer, and ClearProps, and provides a convenient entry point for callers who are annotating HWND-based accessible elements.

-parameters

-param hwnd [in]

Type: HWND

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

-param idObject [in]

Type: DWORD

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

-param idChild [in]

Type: DWORD

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

-param paProps [in]

Type: const MSAAPROPID*

Specifies an array of properties that is to be reset. These properties will revert to the default behavior that they displayed before they were annotated.

-param cProps [in]

Type: int

Specifies the number of properties in the paProps array.

-returns

Type: HRESULT

If successful, returns S_OK, even if the specified properties were never annotated on the accessible object; clearing already-cleared properties is considered a success.

Returns E_INVALIDARG if any of the properties in the paProps array are not supported.

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

For descriptions of return values, see the corresponding SetPropValue, SetPropServer, or ClearProps method.

-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.

Additionally, SetHwndPropStr takes a regular Unicode string as a parameter; the caller does not need to specially allocate a BSTR.

-see-also

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr