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

Article
02/29/2024

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

Syntaxe

HRESULT ClearHmenuProps(
  [in] HMENU            hmenu,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Paramètres

[in] hmenu

Type : HMENU

Identifie l’élément accessible basé sur HMENU à annoter.

[in] idChild

Type : DWORD

Spécifie l'ID enfant de l'élément accessible.

[in] paProps

Type : const MSAAPROPID*

Spécifie un tableau de propriétés à réinitialiser. 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 autres paramètres et des valeurs de retour, consultez la méthode ClearProps .

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 hmenu et idChild .

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