UiaProviderFromIAccessible-Funktion (uiautomationcoreapi.h)

  • Artikel

Erstellt einen Microsoft-Benutzeroberflächenautomatisierungsanbieter basierend auf dem angegebenen Microsoft Active Accessibility-Objekt.

Syntax

HRESULT UiaProviderFromIAccessible(
  [in]  IAccessible               *pAccessible,
  [in]  long                      idChild,
  [in]  DWORD                     dwFlags,
  [out] IRawElementProviderSimple **ppProvider
);

Parameter

[in] pAccessible

Typ: IAccessible*

Ein Zeiger auf das Microsoft Active Accessibility-Objekt.

[in] idChild

Typ: long

Die untergeordnete ID des Microsoft Active Accessibility-Objekts.

[in] dwFlags

Art: DWORD

Einer der folgenden Werte:

UIA_PFIA_DEFAULT

UIA_PFIA_UNWRAP_BRIDGE

[out] ppProvider

Typ: IRawElementProviderSimple**

Der neue Benutzeroberflächenautomatisierungsanbieter.

Rückgabewert

Typ: HRESULT

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

Hinweise

Benutzeroberflächenautomatisierung bietet Abwärtskompatibilität für Microsoft Active Accessibility-Anbieter, indem für sie ein Proxy bereitgestellt wird, der als Microsoft Active Accessibility to UI Automation-Proxy bezeichnet wird. Dieser Proxy wird automatisch erstellt, wenn ein Fenster auf eine WM_GETOBJECT Nachricht antwortet, indem ein Microsoft Active-Barrierefreiheitsanbieter zurückgegeben wird. Verwenden Sie UiaProviderFromIAccessible , wenn Sie manuell einen Microsoft Active Accessibility to UI Automation-Proxy erstellen müssen. beispielsweise beim Implementieren der IAccessibleEx-Schnittstelle .

Einige Eigenschaften, z. B. LabeledBy, müssen als Benutzeroberflächenautomatisierungsanbieter ausgedrückt werden. Ein IAccessibleEx-Anbieter kann UiaProviderFromIAccessible verwenden, um ein IAccessible-Objekt umzuschließen und es als Wert der LabeledBy-Eigenschaft zurückzugeben.

Anforderungen

   
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

UiaIAccessibleFromProvider