IUIAutomation::ElementFromIAccessible-Methode (uiautomationclient.h)

  • Artikel

Ruft ein Benutzeroberflächenautomatisierung-Element für das angegebene barrierefreie Objekt von einem Microsoft Active Accessibility-Server ab.

Syntax

HRESULT ElementFromIAccessible(
  [in]          IAccessible          *accessible,
  [in]          int                  childId,
  [out, retval] IUIAutomationElement **element
);

Parameter

[in] accessible

Typ: IAccessible*

Ein Zeiger auf die IAccessible-Schnittstelle des barrierefreien Objekts.

[in] childId

Typ: int

Die untergeordnete ID des barrierefreien Objekts.

[out, retval] element

Typ: IUIAutomationElement**

Empfängt einen Zeiger auf das Benutzeroberflächenautomatisierung-Element.

Rückgabewert

Typ: HRESULT

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

Hinweise

Mit dieser Methode können Benutzeroberflächenautomatisierung Clients IUIAutomationElement-Schnittstellen für barrierefreie Objekte abrufen, die von einem Microsoft Active Accessibility-Server implementiert werden.

Diese Methode schlägt möglicherweise fehl, wenn der Server Benutzeroberflächenautomatisierung-Anbieterschnittstellen zusammen mit der Unterstützung für Barrierefreiheit von Microsoft Active implementiert.

Die Methode gibt E_INVALIDARG zurück, wenn die zugrunde liegende Implementierung des Microsoft Benutzeroberflächenautomatisierung-Elements kein nativer Microsoft Active Accessibility-Server ist. Das heißt, wenn ein Client versucht, die IAccessible-Schnittstelle für ein Element abzurufen, das ursprünglich von einem Proxyobjekt von Oleacc.dll oder von der UIA-zu-MSAA-Brücke unterstützt wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomation

IUIAutomation::ElementFromHandleBuildCache