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 previamente capturados en la memoria caché.
Sintaxis
HRESULT FindFirstBuildCache(
TreeScope scope,
[in] IUIAutomationCondition *condition,
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **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: 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 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 Microsoft Automatización de la interfaz de usuario; 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 puede intentar buscar elementos en su propia interfaz de usuario, debe realizar todas las llamadas 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 | Value |
---|---|
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) |
Consulte también
Almacenar en caché Automatización de la interfaz de usuario propiedades y patrones de control
Conceptual
Obtener elementos de UI Automation
Referencia
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de