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)

Vedi anche

IUIAutomation

IUIAutomation::GetRootElement