Condividi tramite


Metodo IUIAutomationTreeWalker::GetFirstChildElementBuildCache (uiautomationclient.h)

Recupera il primo elemento figlio dell'elemento Automazione interfaccia utente specificato e memorizza nella cache le proprietà e i modelli di controllo.

Sintassi

HRESULT GetFirstChildElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **first
);

Parametri

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento per cui recuperare il primo figlio.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache che specifica le proprietà e i modelli di controllo da memorizzare nella cache nell'elemento restituito.

[out, retval] first

Tipo: IUIAutomationElement**

Riceve un puntatore al primo elemento figlio o NULL se non è presente alcun elemento figlio.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un elemento può avere elementi figlio aggiuntivi che non corrispondono alla condizione di visualizzazione corrente e quindi non vengono restituiti durante l'esplorazione dell'albero degli elementi.

La struttura dell'albero Automazione interfaccia utente Microsoft cambia come elementi dell'interfaccia utente visibili nella modifica del desktop. Non è garantito che un elemento restituito come primo elemento figlio venga restituito come primo elemento figlio nei passaggi successivi.

Requisiti

   
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)