Metodo IUIAutomationElement::FindFirstBuildCache (uiautomationclient.h)

Articolo
03/03/2024

Recupera il primo elemento figlio o discendente che corrisponde alla condizione specificata, recupera le proprietà richieste e i pattern di controllo e archivia gli elementi prelettura nella cache.

Sintassi

HRESULT FindFirstBuildCache(
                TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **found
);

Parametri

scope

[in] condition

Tipo: IUIAutomationCondition*

Puntatore a una condizione che rappresenta i criteri da trovare.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache che specifica i pattern di controllo e le proprietà da includere nella cache.

[out, retval] found

Tipo: IUIAutomationElement**

Riceve un puntatore all'elemento corrispondente o NULL se non viene trovato alcun elemento corrispondente.

Valore restituito

Tipo: HRESULT

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

Commenti

L'ambito della ricerca è relativo all'elemento in cui viene chiamato il metodo . Gli elementi vengono restituiti nell'ordine in cui sono stati rilevati nell'albero.

Questa funzione non può cercare gli elementi predecessori nell'albero di Microsoft Automazione interfaccia utente, ovvero TreeScope_Ancestors non è un valore valido per il parametro scope.

Quando si cercano finestre di primo livello sul desktop, assicurarsi di specificare TreeScope_Children nel parametro di ambito , non TreeScope_Descendants. Una ricerca nell'intero sottoalbero del desktop potrebbe scorrere migliaia di elementi e causare un overflow dello stack.

Se l'applicazione client potrebbe tentare di trovare elementi nella propria interfaccia utente, è necessario eseguire tutte le chiamate Automazione interfaccia utente su un thread separato.

Per eseguire ricerche nell'albero non elaborato, specificare l'oggetto TreeScope appropriato nel parametro cacheRequest .

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 (include UIAutomation.h)