Metodo IUIAutomationElement::FindFirst (uiautomationclient.h)
Recupera il primo elemento figlio o discendente che corrisponde alla condizione specificata.
Sintassi
HRESULT FindFirst(
TreeScope scope,
[in] IUIAutomationCondition *condition,
[out, retval] IUIAutomationElement **found
);
Parametri
scope
[in] condition
Tipo: IUIAutomationCondition*
Puntatore a una condizione che rappresenta i criteri da trovare.
[out, retval] found
Tipo: IUIAutomationElement**
Riceve un puntatore all'elemento . Se non viene trovato alcun elemento corrispondente, 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.
Questa funzione ignora gli elementi nell'albero non elaborato. Chiamare FindFirstBuildCache per cercare l'albero non elaborato specificando l'oggetto TreeScope appropriato nell'oggetto IUIAutomationCacheRequest passato a tale funzione.
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) |
Vedi anche
Informazioni concettuali
Ottenere elementi di automazione interfaccia utente
Riferimento
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per