UiaProviderForNonClient-Funktion (uiautomationcoreapi.h)
Ruft den Anbieter für den gesamten Nicht-Clientbereich eines Fensters oder für ein Steuerelement im Nicht-Clientbereich eines Fensters ab.
Syntax
HRESULT UiaProviderForNonClient(
[in] HWND hwnd,
[in] long idObject,
[in] long idChild,
[out] IRawElementProviderSimple **ppProvider
);
Parameter
[in] hwnd
Typ: HWND
Das Fenster, das den Nicht-Clientbereich oder das Nicht-Client-Steuerelement besitzt.
[in] idObject
Typ: long
Der Objektbezeichner des Nicht-Clientsteuerelements oder OBJID_WINDOW für den gesamten Nicht-Clientbereich. Eine Liste der möglichen Werte finden Sie unter Objektbezeichner.
[in] idChild
Typ: long
Der untergeordnete Bezeichner des Nicht-Clientsteuerelements.
[out] ppProvider
Typ: IRawElementProviderSimple**
Empfängt den Anbieter für den Nicht-Clientbereich oder das Nicht-Client-Steuerelement.
Rückgabewert
Typ: HRESULT
Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert vorhanden ist.
Hinweise
Diese Funktion gibt den Standardanbieter von Microsoft Benutzeroberflächenautomatisierung für den Nicht-Clientbereich eines Fensters zurück. Benutzeroberflächenautomatisierung unterstützt den Nicht-Clientbereich ohne explizite Hilfe aus dem Fenster. Sie können die Unterstützung überschreiben und anpassen, indem Sie die IRawElementProviderSimple-Schnittstelle verwenden, die von dieser Funktion abgerufen wird.
Diese Funktion ist besonders nützlich, wenn Sie sie mit dem ProviderOptions_RefuseNonClientSupport-Flag verwenden, das den Benutzeroberflächenautomatisierung Standardanbieter für den Nicht-Clientbereich deaktiviert, sodass das Fenster einen eigenen Anbieter bereitstellen kann.
Zu den unterstützten Objekt-IDs für Steuerelemente im Nicht-Clientbereich gehören OBJID_WINDOW, OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU und OBJID_SIZEGRIP. Verwenden Sie für OBJID_TITLEBAR die untergeordnete ID, um zwischen der gesamten Titelleiste und den darin enthaltenen Schaltflächen zu unterscheiden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiautomationcoreapi.h |
| Bibliothek | Uiautomationcore.lib |
| DLL | Uiautomationcore.dll |