Método IUIAutomation::GetRootElementBuildCache (uiautomationclient.h)
Recupera el elemento Automatización de la interfaz de usuario que representa el escritorio, captura previamente las propiedades solicitadas y los patrones de control, y almacena los elementos previamente capturados en la memoria caché.
Sintaxis
HRESULT GetRootElementBuildCache(
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **root
);
Parámetros
[in] cacheRequest
Tipo: IUIAutomationCacheRequest*
Puntero a la solicitud de caché, que especifica las propiedades y los patrones de control que se almacenarán en la memoria caché.
[out, retval] root
Tipo: IUIAutomationElement**
Recibe un puntero al elemento Automatización de la interfaz de usuario.
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
Puede usar el elemento raíz como punto de partida para buscar otros elementos mediante los métodos FindAll y FindFirst .
Al buscar desde el elemento raíz, asegúrese de especificar TreeScope_Children en el ámbito de la búsqueda, 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.
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) |