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

Recupera el primer elemento secundario o descendiente que coincide con la condición especificada.

Sintaxis

HRESULT FindFirst(
  [in]          TreeScope              scope,
  [in]          IUIAutomationCondition *condition,
  [out, retval] IUIAutomationElement   **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: IUIAutomationElement

Recibe un puntero al elemento . NULL se devuelve 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 encontraron 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.

Esta función omite los elementos del árbol sin procesar. Llame a FindFirstBuildCache para buscar en el árbol sin procesar especificando el TreeScope adecuado en el IUIAutomationCacheRequest pasado a esa función.

Requisitos

Consulte también

conceptual de

FindAll

FindAllBuildCache

FindFirstBuildCache

IUIAutomationElement

obtener elementos de automatización de la interfaz de usuario

de referencia de