Share via

IRawElementProviderHwndOverride::GetOverrideProviderForHwnd-Methode (uiautomationcore.h)

  • Artikel

Ruft einen Benutzeroberflächenautomatisierung Anbieter für das angegebene Element ab.

Syntax

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parameter

[in] hwnd

Typ: HWND

Das Fensterhandle des Elements.

[out, retval] pRetVal

Typ: IRawElementProviderSimple**

Empfängt einen Zeiger auf den neuen Anbieter für das angegebene Fenster oder NULL , wenn der Anbieter nicht überschrieben wird. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird durch Fragmentwurzeln implementiert, die fensterbasierte untergeordnete Elemente enthalten. Standardmäßig werden steuerelemente, die in Windows gehostet werden, von Standardanbietern zusätzlich zu allen benutzerdefinierten Anbietern bereitgestellt. Die Standardanbieter behandeln alle Fenster innerhalb eines übergeordneten Fensters als gleichgeordnete Fenster. Wenn Sie die Benutzeroberflächenautomatisierung Struktur so umstrukturieren möchten, dass ein fensterbasiertes Steuerelement als untergeordnetes Element eines anderen angesehen wird, müssen Sie den Standardanbieter überschreiben, indem Sie diese Methode im Fragmentstamm implementieren. Der zurückgegebene Anbieter kann zusätzliche Eigenschaften bereitstellen oder Eigenschaften der angegebenen Komponente außer Kraft setzen.

Der zurückgegebene Anbieter muss Teil der Fragmentstruktur sein. Sie kann zusätzliche Eigenschaften bereitstellen oder Eigenschaften der angegebenen Komponente außer Kraft setzen.

Wenn der zurückgegebene Anbieter IRawElementProviderFragment implementiert, sollte der Anbieter Teil der Struktur des Fragments sein und erreichbar sein, indem er aus dem Stamm des Fragments navigiert.

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 (include UIAutomation.h)

Weitere Informationen

IRawElementProviderHwndOverride