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

Recupera el primer elemento secundario o descendiente que coincide con la condición especificada, captura previamente las propiedades solicitadas y los patrones de control, y almacena los elementos almacenados previamente en la memoria caché.

Sintaxis

HRESULT FindFirstBuildCache(
  [in]          TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [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.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntero a una solicitud de caché que especifica los patrones de control y las propiedades que se van a incluir en la memoria caché.

[out, retval] found

Tipo: IUIAutomationElement

Recibe un puntero al elemento coincidente o NULL 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.

Para buscar en el árbol sin procesar, especifique el TreeScope adecuado en el parámetro cacheRequest.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 R2, Windows Server 2008 con SP2 y Platform Update para Windows Server 2008, Windows Server 2003 con SP2 y Platform Update para Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	uiautomationclient.h (include UIAutomation.h)

Consulte también

propiedades y patrones de control de automatización de la interfaz de usuario de almacenamiento en caché

conceptual de

FindAll

FindAllBuildCache

FindFirst

IUIAutomationElement

obtener elementos de automatización de la interfaz de usuario

de referencia de