IUIAutomation::ElementFromIAccessibleBuildCache-Methode (uiautomationclient.h)

  • Artikel

Ruft ein Benutzeroberflächenautomatisierungselement für das angegebene barrierefreie Objekt von einem Microsoft Active Accessibility-Server ab, stellt die angeforderten Eigenschaften und Steuerelementmuster vor und speichert die vorab zurückgegebenen Elemente im Cache.

Syntax

HRESULT ElementFromIAccessibleBuildCache(
  [in]          IAccessible               *accessible,
  [in]          int                       childId,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [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.

[in] cacheRequest

Typ: IUIAutomationCacheRequest**

Die Adresse der Cacheanforderung, die die Eigenschaften und Steuerelementmuster angibt, die im Cache gespeichert werden sollen.

[out, retval] element

Typ: IUIAutomationElement**

Empfängt einen Zeiger auf das Ui Automation-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 Microsoft UI Automation-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ächenautomatisierungsanbieterschnittstellen zusammen mit microsoft Active Accessibility-Unterstützung implementiert.

Die Methode gibt E_INVALIDARG zurück, wenn die zugrunde liegende Implementierung des UI Automation-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

   
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