Metodo IUIAutomation::GetRootElementBuildCache (uiautomationclient.h)
Recupera l'elemento Automazione interfaccia utente che rappresenta il desktop, prefeta le proprietà e i modelli di controllo richiesti e archivia gli elementi prefeted nella cache.
Sintassi
HRESULT GetRootElementBuildCache(
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **root
);
Parametri
[in] cacheRequest
Tipo: IUIAutomationCacheRequest*
Puntatore alla richiesta di cache, che specifica le proprietà e i modelli di controllo da archiviare nella cache.
[out, retval] root
Tipo: IUIAutomationElement**
Riceve un puntatore all'elemento Automazione interfaccia utente.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
È possibile usare l'elemento radice come punto di partenza per trovare altri elementi usando i metodi FindAll e FindFirst .
Quando si esegue la ricerca dall'elemento radice, assicurarsi di specificare TreeScope_Children nell'ambito della ricerca, non TreeScope_Descendants. Una ricerca attraverso l'intero sottoalbero del desktop potrebbe scorrere migliaia di elementi e portare a un overflow dello stack.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | uiautomationclient.h (includere UIAutomation.h) |