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

Article
02/29/2024

Les serveurs utilisent ClearProps pour restaurer les valeurs par défaut des propriétés des éléments accessibles qu’ils avaient précédemment annotés.

Si les serveurs connaissent le HWND de l’objet qu’ils veulent effacer, ils peuvent utiliser IAccPropServices ::ClearHwndProps.

Syntaxe

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Paramètres

[in] pIDString

Type : const BYTE*

Identifie l'élément accessible dont l'annotation doit être annulée.

[in] dwIDStringLen

Type : DWORD

Longueur de pIDString.

[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

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

Remarques

Consultez la section prise en charge pour obtenir la liste des propriétés prises en charge et leurs types attendus.

L’effacement de l’annotation d’une propriété entraîne la libération de toutes les ressources associées. Si un serveur de propriétés de rappel a été utilisé (voir SetPropServer), il est libéré.

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

Partager via