Partager via


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

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

Voir aussi

ClearHwndProps

IAccPropServices

SetHwndProp

SetHwndPropStr

SetPropServer