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

Article
02/29/2024

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

Syntaxe

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

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 géré par l'objet de rappel spécifié.

[in] cProps

Type : int

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

[in] pServer

Type : IAccPropServer*

Spécifie l'objet de rappel, qui est appelé lorsqu'un client appelle l'une des propriétés substituées.

[in] annoScope

Type : AnnoScope

Peut être ANNO_THIS, indiquant que l'annotation affecte uniquement l'élément accessible indiqué, ou ANNO_CONTAINER, indiquant qu'elle s'applique à l'élément et à ses éléments enfants immédiats.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

Renvoie E_INVALIDARG si l’une des propriétés du tableau paProps ne sont pas prises en charge, si la chaîne d’identité n’est pas valide ou si annoScope n’est pas l’une des propriétés de ANNO_THIS ou ANNO_CONTAINER.

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