IRawElementProviderSimple::get_HostRawElementProvider-Methode (uiautomationcore.h)
Gibt den Hostanbieter für dieses Element an.
Diese Eigenschaft ist schreibgeschützt.
Syntax
HRESULT get_HostRawElementProvider(
IRawElementProviderSimple **pRetVal
);
Parameter
pRetVal
Rückgabewert
Keine
Bemerkungen
Diese Eigenschaft ist im Allgemeinen der Microsoft Benutzeroberflächenautomatisierung Anbieter für das Fenster eines benutzerdefinierten Steuerelements. Benutzeroberflächenautomatisierung verwendet diesen Anbieter in Kombination mit dem benutzerdefinierten Anbieter. Beispielsweise wird der Laufzeitbezeichner des Elements in der Regel vom Hostanbieter abgerufen.
Ein Hostanbieter muss in den folgenden Fällen zurückgegeben werden: wenn das Element ein Fragmentstamm ist, wenn es sich bei dem Element um ein einfaches Element handelt (z. B. eine Druckschaltfläche), und wenn der Anbieter ein Platzhalter für die neu positionierte Position ist (weitere Informationen finden Sie unter Provider Repositioning). In anderen Fällen sollte die Eigenschaft NULL sein.
Beispiele
Im folgenden Beispiel wird der Hostanbieter für das Fenster zurückgegeben, in dem das steuerelement gehostet wird, das von diesem Anbieter bereitgestellt wird.
HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
return UiaHostProviderFromHwnd(controlHWnd, pRetVal);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiautomationcore.h (uiAutomation.h einschließen) |