Compatibilidad de UI Automation para el tipo de control Tree
Nota
Esta documentación está dirigida a los desarrolladores de .NET Framework que quieran usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para ver la información más reciente acerca de la automatización de la interfaz de usuario, consulte Windows Automation API: automatización de la interfaz de usuario.
Este tema proporciona información sobre la compatibilidad de la UI Automation con el tipo de control árbol. En UI Automation, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la propiedad ControlTypeProperty. Las condiciones incluyen directrices específicas para la estructura de árbol de Automatización de la interfaz de usuario, los valores de propiedad de Automatización de la interfaz de usuario y los patrones de control.
El tipo de control Tres se usa para contenedores cuyo contenido tiene relevancia como una jerarquía de nodos, como con la manera en que se muestran archivos y carpetas en el panel izquierdo de Microsoft Windows Explorer. Cada nodo tiene el potencial de contener otros nodos, denominados nodos secundarios. Los nodos primarios o los nodos que contienen nodos secundarios se pueden mostrar expandidos o contraídos.
En las secciones siguientes se definen la estructura de árbol, las propiedades, los patrones de control y los eventos para el tipo de control de árbol de UI Automation necesarios. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de árbol, ya sea Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Estructura de árbol de Automatización de la interfaz de usuario necesaria
En la tabla siguiente se describe la vista de control y la vista de contenido del árbol de UI Automation que pertenece a los controles de árbol y se describe lo que puede incluirse en cada vista. Para más información sobre el árbol de automatización de la interfaz de usuario, consulte Introducción al árbol de automatización de la interfaz de usuario.
| Vista de control | Vista de contenido |
|---|---|
Árbol
|
Árbol
|
La vista de control del árbol de UI Automation consta de:
Cero a muchos elementos dentro del contenedor (los elementos se pueden basar en el elemento del árbol, el elemento de datos u otro tipo de control).
Cero, una o dos barras de desplazamiento.
La vista de contenido del árbol UI Automation consta de cero a muchos elementos dentro del contenedor (los elementos se pueden basar en el elemento del árbol, el elemento de datos u otro tipo de control).
Propiedades de Automatización de la interfaz de usuario necesarias
En la tabla siguiente se muestran las propiedades de UI Automation cuyo valor o definición es especialmente relevante para los controles de lista. Para más información sobre las propiedades de automatización de la interfaz de usuario, consulte Propiedades de automatización de la interfaz de usuario para clientes.
| Propiedad de automatización de interfaz de usuario | Valor | Notas |
|---|---|---|
| AutomationIdProperty | Vea las notas. | El valor de esta propiedad debe ser único en todos los controles de una aplicación. |
| BoundingRectangleProperty | Vea las notas. | El rectángulo exterior que contiene el control completo. |
| ClickablePointProperty | Vea las notas. | Los controles Tree tienen un punto interactivo que hará que el árbol o a uno los elementos del contenedor del árbol tenga el enfoque en ellos. Solo obtiene un punto interactivo para un árbol si puede hacer clic en algún lugar que no haga que uno de los elementos se seleccione ni obtenga el enfoque. |
| ControlTypeProperty | Árbol | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| IsContentElementProperty | True | El control de árbol siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| IsControlElementProperty | True | El control de árbol siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario. |
| IsKeyboardFocusableProperty | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| LabeledByProperty | Vea las notas. | Si el control de árbol tiene una etiqueta asociada, esta propiedad devolverá un AutomationElement para esa etiqueta. De lo contrario, la propiedad devolverá una referencia nula (Nothing en Microsoft Visual Basic .NET). |
| LocalizedControlTypeProperty | "árbol" | Cadena localizada que corresponde al tipo de control List. |
| NameProperty | Vea las notas. | El valor de la propiedad del nombre de un control de árbol normalmente procede del texto que etiqueta el control. Si no hay ninguna etiqueta de texto, el desarrollador de aplicaciones debe proporcionar un valor para esta propiedad. |
Patrones de control de Automatización de la interfaz de usuario necesarios
En la tabla siguiente se muestran los patrones de control de Automatización de la interfaz de usuario requeridos para ser admitidos por los controles de lista. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.
| Patrón de control/Propiedad de patrón | Soporte técnico/valor | Notas |
|---|---|---|
| ISelectionProvider | Depende | Los controles de árbol que contienen un conjunto de elementos seleccionables deben implementar este patrón de control. Este patrón de control no tiene que implementarse si la selección de un elemento no transmite información significativa al usuario. |
| CanSelectMultiple | Vea las notas. | Implemente esta propiedad si el control del árbol admite selección múltiple (la mayoría de los controles de árbol admiten selección múltiple). |
| IsSelectionRequired | Vea las notas. | El valor de esta propiedad se expone si el control requiere que se seleccione un elemento. |
| IScrollProvider | Depende | Implemente este patrón de control si el contenido del contenedor de árbol puede desplazarse. |
Eventos de Automatización de la interfaz de usuario necesarios
En la tabla siguiente se muestran los eventos de UI Automation que se deben admitir por parte de todos los controles de árbol. Para más información sobre los eventos, vea UI Automation Events Overview.
| Evento de Automatización de la interfaz de usuario | Soporte técnico | Notas |
|---|---|---|
| InvalidatedEvent | Depende | None |
| Evento cambiado por propiedadBoundingRectangleProperty . | Obligatorio | None |
| Evento cambiado por propiedadIsOffscreenProperty . | Obligatorio | None |
| Evento cambiado por propiedadIsEnabledProperty . | Obligatorio | None |
| Evento cambiado por propiedadHorizontallyScrollableProperty . | Depende | None |
| Evento cambiado por propiedadHorizontalScrollPercentProperty . | Depende | None |
| Evento cambiado por propiedadHorizontalViewSizeProperty . | Depende | None |
| Evento cambiado por propiedadVerticalScrollPercentProperty . | Depende | None |
| Evento cambiado por propiedadVerticallyScrollableProperty . | Depende | None |
| Evento cambiado por propiedadVerticalViewSizeProperty . | Depende | None |
| AutomationFocusChangedEvent | Obligatorio | None |
| StructureChangedEvent | Obligatorio | None |