Método IUIAutomationTreeWalker::NormalizeElement (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.

Sintaxis

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

Parámetros

[in] element

Tipo: IUIAutomationElement*

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

[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). Pero en primer lugar, se prueba el elemento pasado para ver si coincide con una condición de normalización. Si es así, se devuelve el elemento pasado, aunque no sea un antecesor.

El método devuelve UIA_E_ELEMENTNOTAVAILABLE si no se ha encontrado ningún elemento coincidente.

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::Normalize 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 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)