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