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

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

Voir aussi

IRawElementProviderHwndOverride