Share via

Méthode IRawElementProviderHwndOverride ::GetOverrideProviderForHwnd (uiautomationcore.h)

  • Article

Obtient un fournisseur UI Automation pour l’élément spécifié.

Syntaxe

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Paramètres

[in] hwnd

Type : HWND

Handle de fenêtre de l’élément.

[out, retval] pRetVal

Type : IRawElementProviderSimple**

Reçoit un pointeur vers le nouveau fournisseur pour la fenêtre spécifiée, ou NULL si le fournisseur n’est pas remplacé. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode est implémentée par des racines de fragment qui contiennent des éléments enfants basés sur une fenêtre. Par défaut, les contrôles hébergés dans Windows sont pris en charge par les fournisseurs par défaut en plus des fournisseurs personnalisés. Les fournisseurs par défaut traitent toutes les fenêtres d’une fenêtre parente comme des frères. Si vous souhaitez restructurer l’arborescence de UI Automation afin qu’un contrôle basé sur une fenêtre soit considéré comme un enfant d’un autre, vous devez remplacer le fournisseur par défaut en implémentant cette méthode sur la racine du fragment. Le fournisseur retourné peut fournir des propriétés supplémentaires ou remplacer des propriétés du composant spécifié.

Le fournisseur retourné doit faire partie de l’arborescence de fragments. Il peut fournir des propriétés supplémentaires ou remplacer des propriétés du composant spécifié.

Si le fournisseur retourné implémente IRawElementProviderFragment, le fournisseur doit faire partie de l’arborescence du fragment et être accessible en naviguant à partir de la racine du fragment.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

IRawElementProviderHwndOverride