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

Vedi anche

IUIAutomation

IUIAutomation::GetRootElement