Méthode IRawElementProviderSimple ::get_HostRawElementProvider (uiautomationcore.h)

Spécifie le fournisseur d’hôte pour cet élément.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_HostRawElementProvider(
  IRawElementProviderSimple **pRetVal
);

Paramètres

pRetVal

Valeur de retour

None

Remarques

Cette propriété est généralement le fournisseur Microsoft UI Automation pour la fenêtre d’un contrôle personnalisé. UI Automation utilise ce fournisseur en combinaison avec le fournisseur personnalisé. Par exemple, l’identificateur d’exécution de l’élément est généralement obtenu à partir du fournisseur hôte.

Un fournisseur hôte doit être retourné dans les cas suivants : lorsque l’élément est une racine de fragment, quand l’élément est un élément simple (par exemple, un bouton push) et lorsque le fournisseur est un espace réservé de repositionnement (pour plus d’informations, consultez Repositionnement du fournisseur). Dans d’autres cas, la propriété doit avoir la valeur NULL.

Exemples

L’exemple suivant retourne le fournisseur d’hôte pour la fenêtre qui héberge le contrôle pris en charge par ce fournisseur.

HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
    return UiaHostProviderFromHwnd(controlHWnd, pRetVal); 
}
            

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

IRawElementProviderSimple

UiaHostProviderFromHwnd