Obtener elementos de UI Automation

Este tema describe las distintas formas de obtener objetos AutomationElement para los elementos de la interfaz de usuario (UI).

Elemento raíz

Todas las búsquedas de objetos AutomationElement deben tener un punto de inicio. Puede ser cualquier elemento, incluidos el escritorio, una ventana de aplicación o un control.

El elemento raíz para el escritorio, del que descienden todos los elementos, se obtiene de la propiedad estática AutomationElement.RootElement .

Condiciones

Para la mayoría de técnicas que puede usar para recuperar elementos UI Automation, debe especificar un elemento Condition, que es un conjunto de criterios que definen los elementos que quiere recuperar.

La condición más simple es TrueCondition, un objeto predefinido que especifica que se devolverán todos los elementos dentro del ámbito de búsqueda. FalseCondition, que es el elemento opuesto de TrueCondition, no es tan útil, ya que impediría que se encontraran elementos.

Hay otras tres condiciones predefinidas que se pueden utilizar por sí solas o en combinación con otras condiciones: ContentViewCondition, ControlViewConditiony RawViewCondition. RawViewCondition, por sí sola, equivale a TrueCondition, porque no filtra los elementos por sus propiedades IsControlElement o IsContentElement .

Otras condiciones se componen de uno o varios objetos PropertyCondition , cada uno de los cuales especifica un valor de propiedad. Por ejemplo, un elemento PropertyCondition podría especificar que el elemento está habilitado o que admite un patrón de control determinado.

Las condiciones se pueden combinar con lógica booleana, mediante la construcción de objetos de tipos AndCondition, OrConditiony NotCondition.

Ámbito de búsqueda

Las búsquedas realizadas con FindFirst o FindAll deben tener un ámbito así como un punto de inicio.

El ámbito define el espacio alrededor del punto de inicio en el que se va a buscar. Esto podría incluir el propio elemento, sus elementos relacionados, su elemento primario, sus antecesores, sus elementos secundarios inmediatos y sus descendientes.

El ámbito de una búsqueda se define mediante una combinación bit a bit de valores de la enumeración TreeScope .

Búsqueda de un elemento conocido

Para buscar un elemento conocido, identificado por su Name, AutomationIdo alguna otra propiedad o combinación de propiedades, lo más fácil es utilizar el método FindFirst . Si el elemento que se busca es una ventana de aplicación, el punto inicial de la búsqueda puede ser el elemento RootElement.

Esta forma de buscar elementos UI Automation es especialmente útil en escenarios de pruebas automatizadas.

Búsqueda de elementos en un subárbol

Para encontrar todos los elementos que cumplan criterios concretos relacionados con un elemento conocido, puede utilizar FindAll. Por ejemplo, podría utilizar este método para recuperar elementos de lista o elementos de menú de una lista o un menú, o para identificar todos los controles de un cuadro de diálogo.

Recorrer un subárbol

Si no tiene conocimiento previo de las aplicaciones con las que se puede usar el cliente, puede construir un subárbol de todos los elementos de interés con la clase TreeWalker . La aplicación podría hacer esto en respuesta a un evento de cambio de foco; es decir, cuando una aplicación o un control recibe el foco de entrada, el cliente de Automatización de la interfaz de usuario examina los elementos secundarios y quizás todos los descendientes del elemento en el que está el foco.

Otra forma en que se puede utilizar TreeWalker es para identificar los antecesores de un elemento. Por ejemplo, al recorrer el árbol en sentido ascendente, se puede identificar la ventana primaria de un control.

Puede usar TreeWalker mediante la creación de un objeto de la clase (definiendo los elementos de interés pasando un elemento Condition) o mediante uno de los siguientes objetos predefinidos que se definen como campos de TreeWalker.

Después de haber obtenido un elemento TreeWalker, su uso es sencillo. Basta con llamar a los métodos Get para navegar entre elementos del subárbol.

El método Normalize puede utilizarse para desplazarse a un elemento del subárbol desde otro elemento que no forma parte de la vista. Por ejemplo, suponga que ha creado una vista de un subárbol mediante ContentViewWalker. Después, la aplicación recibe la notificación de que una barra de desplazamiento ha recibido el foco de entrada. Como una barra de desplazamiento no es un elemento de contenido, no está presente en la vista del subárbol. Sin embargo, puede pasar el elemento AutomationElement que representa la barra de desplazamiento a Normalize y recuperar el antecesor más cercano que se encuentra en la vista de contenido.

Otras maneras de recuperar un elemento

Además de las búsquedas y la navegación, puede recuperar un elemento AutomationElement de las maneras siguientes.

Desde un evento

Cuando la aplicación recibe un evento UI Automation , el objeto de origen que se pasa al controlador de eventos es un elemento AutomationElement. Por ejemplo, si se ha suscrito a eventos de cambio de foco, el origen que se pasó a su AutomationFocusChangedEventHandler es el elemento que recibió el foco.

Para obtener más información, consulta Subscribe to UI Automation Events.

Desde un punto

Si tiene coordenadas de pantalla (por ejemplo, una posición del cursor), puede recuperar un elemento AutomationElement con el método estático FromPoint .

Desde un identificador de ventana

Para recuperar un elemento AutomationElement desde un HWND, use el método estático FromHandle .

Desde el control con el foco

Puede recuperar un elemento AutomationElement que representa el control con el foco desde la propiedad estática FocusedElement .

Consulte también

• Búsqueda de un elemento de Automatización de la interfaz de usuario basada en una condición de propiedad
• Navegar entre elementos de UI Automation con TreeWalker
• Información general sobre el árbol de la UI Automation