Método IUIAutomationElement::FindAll (uiautomationclient.h)

Devuelve todos los elementos de automatización de la interfaz de usuario que cumplen la condición especificada.

Sintaxis

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

Parámetros

[in] scope

Tipo: treeScope de

Combinación de valores que especifican el ámbito de la búsqueda.

[in] condition

Tipo: IUIAutomationCondition

Puntero a una condición que representa los criterios que se van a coincidir.

[out, retval] found

Tipo: IUIAutomationElementArray**

Recibe un puntero a una matriz de elementos coincidentes. Devuelve una matriz vacía si no se encuentra ningún elemento coincidente.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

El ámbito de la búsqueda es relativo al elemento en el que se llama al método . Los elementos se devuelven en el orden en que se encuentran en el árbol.

Esta función no puede buscar elementos antecesores en el árbol de Automatización de la interfaz de usuario de Microsoft; es decir, TreeScope_Ancestors no es un valor válido para el parámetro de ámbito de .

Al buscar ventanas de nivel superior en el escritorio, asegúrese de especificar TreeScope_Children en el parámetro de ámbito de , no TreeScope_Descendants. Una búsqueda a través del subárbol completo del escritorio podría recorrer en iteración miles de elementos y provocar un desbordamiento de pila.

Si la aplicación cliente puede intentar encontrar elementos en su propia interfaz de usuario, debe realizar todas las llamadas de automatización de la interfaz de usuario en un subproceso independiente.

Requisitos

Consulte también

conceptual de

FindAllBuildCache

FindFirst

FindFirstBuildCache

IUIAutomationElement

obtener elementos de automatización de la interfaz de usuario

de referencia de