UiaProviderForNonClient-Funktion (uiautomationcoreapi.h)

  • Artikel

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

Weitere Informationen

Funktionen für Anbieter