IUIAutomation::ElementFromIAccessible-Methode (uiautomationclient.h)
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) |