Método IUIAutomationTreeWalker::NormalizeElementBuildCache (uiautomationclient.h)

Recupera el elemento antecesor más cercano al elemento de Automatización de la interfaz de usuario de Microsoft especificado en la vista de árbol, captura previamente las propiedades solicitadas y los patrones de control, y almacena los elementos previamente capturados en la memoria caché.

Sintaxis

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

Parámetros

[in] element

Tipo: IUIAutomationElement*

Puntero al elemento desde el que se va a iniciar la normalización.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Puntero a una solicitud de caché que especifica las propiedades y los patrones de control que se van a almacenar en caché en el elemento devuelto.

[out, retval] normalized

Tipo: IUIAutomationElement**

Recibe un puntero al elemento antecesor más cercano al elemento especificado en la vista de árbol.

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 elemento se normaliza navegando por la cadena antecesora en el árbol hasta que se alcanza un elemento que cumpla la condición de vista (especificada por una llamada anterior a IUIAutomationTreeWalker::Condition). Si se alcanza el elemento raíz, se devuelve el elemento raíz, aunque no cumpla la condición de vista.

Este método es útil para las aplicaciones que obtienen referencias a elementos de automatización de la interfaz de usuario mediante pruebas de posicionamiento. Es posible que la aplicación quiera trabajar solo con tipos específicos de elementos y puede usar IUIAutomationTreeWalker::NormalizeElement para asegurarse de que, independientemente del elemento que se recupere inicialmente (por ejemplo, cuando una barra de desplazamiento obtiene el foco de entrada), solo se recupera el elemento de interés (como un elemento de contenido).

Requisitos

Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma 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)