Méthode IAccPropServices ::ClearHwndProps (oleacc.h)

Article
02/29/2024

Cette méthode encapsule SetPropValue, SetPropServer et ClearProps, et fournit un point d’entrée pratique pour les appelants qui annotent des éléments accessibles basés sur HWND.

Syntaxe

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Paramètres

[in] hwnd

Type : HWND

Identifie l'élément accessible qui doit être annoté. Cela remplace la chaîne d'identité.

[in] idObject

Type : DWORD

Identifie l'élément accessible qui doit être annoté. Cela remplace la chaîne d'identité.

[in] idChild

Type : DWORD

Identifie l'élément accessible qui doit être annoté. Cela remplace la chaîne d'identité.

[in] paProps

Type : const MSAAPROPID*

Spécifie un tableau de propriétés qui doit être réinitialisé. Ces propriétés reprendront le comportement par défaut qu'elles affichaient avant leur annotation.

[in] cProps

Type : int

Spécifie le nombre de propriétés dans le tableau paProps.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK, même si les propriétés spécifiées n’ont jamais été annotées sur l’objet accessible ; L’effacement des propriétés déjà effacées est considéré comme un succès.

Retourne E_INVALIDARG si l’une des propriétés du tableau paProps n’est pas prise en charge.

Peut retourner d’autres codes d’erreur dans des conditions d’erreur exceptionnelles, telles qu’une mémoire insuffisante.

Pour obtenir une description des valeurs de retour, consultez la méthode SetPropValue, SetPropServer ou ClearProps correspondante.

Remarques

En utilisant cette méthode, l’appelant n’a pas besoin d’obtenir une chaîne d’identité ; il peut spécifier directement les paramètres hwnd, idObject et idChild .

En outre, SetHwndPropStr prend une chaîne Unicode normale en tant que paramètre ; l’appelant n’a pas besoin d’allouer spécialement un BSTR.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h (incluez d’abord OleAcc.h Inclure Initguid.h))
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 2.0 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 98