IRawElementProviderSimple::get_HostRawElementProvider-Methode (uiautomationcore.h)

  • Artikel

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)

Weitere Informationen

Irawelementprovidersimple

UiaHostProviderFromHwnd