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

Artículo
08/26/2023

Devuelve todos los elementos de automatización de la interfaz de usuario que cumplen la condición especificada, captura previamente las propiedades solicitadas y los patrones de control, y almacena los elementos previamente capturados en la memoria caché.

Sintaxis

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

Parámetros

scope

[in] condition

Tipo: IUIAutomationCondition*

Puntero a una condición que representa los criterios que deben 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: IUIAutomationElementArray**

Recibe un puntero a una matriz de elementos coincidentes. Si no hay coincidencias, se devuelve NULL .

Valor devuelto

Tipo: HRESULT

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

Comentarios

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 scope .

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

Si la aplicación cliente podría 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


Cliente mínimo compatible	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 compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)