IAccPropServices ::SetHwndProp, méthode (oleacc.h)

Article
03/04/2024

Cette méthode encapsule SetPropValue, fournissant un point d’entrée pratique pour les appelants qui annotent des éléments accessibles basés sur HWND. Si la nouvelle valeur est une chaîne, vous pouvez utiliser IAccPropServices ::SetHwndPropStr à la place.

Syntaxe

HRESULT SetHwndProp(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

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] idProp

Type : MSAAPROPID

Spécifie la propriété de cet élément à annoter.

[in] var

Type : VARIANT

Spécifie une nouvelle valeur pour cette propriété.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

Retourne E_INVALIDARG si la propriété idProp n’est pas prise en charge.

Peut retourner d’autres codes d’erreur dans des conditions d’erreur exceptionnelles telles que la mémoire insuffisante.

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 .

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