Metodo IUIAutomationElement::FindAll (uiautomationclient.h)

Articolo
03/13/2024

Restituisce tutti gli elementi Automazione interfaccia utente che soddisfano la condizione specificata.

Sintassi

HRESULT FindAll(
                TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [out, retval] IUIAutomationElementArray **found
);

Parametri

scope

[in] condition

Tipo: IUIAutomationCondition*

Puntatore a una condizione che rappresenta i criteri da corrispondere.

[out, retval] found

Tipo: IUIAutomationElementArray**

Riceve un puntatore a una matrice di elementi corrispondenti. Restituisce una matrice vuota 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 vengono rilevati nell'albero.

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

Quando si cerca una finestra di primo livello sul desktop, assicurarsi di specificare TreeScope_Children nel parametro ambito , non TreeScope_Descendants. Una ricerca attraverso l'intero sottoalbero del desktop potrebbe scorrere migliaia di elementi e portare a un overflow dello stack.

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

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)