IRawElementProviderHwndOverride::GetOverrideProviderForHwnd-Methode (uiautomationcore.h)
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) |