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
| 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) |