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

Article
02/29/2024

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

Syntaxe

HRESULT SetHwndPropStr(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] LPCWSTR    str
);

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

Type : LPCWSTR

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

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

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