Metodo IUIAutomationElement::FindAllBuildCache (uiautomationclient.h)

Articolo
08/26/2023

Restituisce tutti gli elementi Automazione interfaccia utente che soddisfano la condizione specificata, prefeta le proprietà richieste e i pattern di controllo e archivia gli elementi prelettura nella cache.

Sintassi

HRESULT FindAllBuildCache(
                TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **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: IUIAutomationElementArray**

Riceve un puntatore a una matrice di elementi corrispondenti. Se non sono presenti corrispondenze, viene restituito NULL .

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.

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