Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota:
Esta documentación está pensada para desarrolladores de .NET Framework que desean usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para obtener la información más reciente sobre la automatización de la interfaz de usuario, consulte API de Windows Automation: Automatización de la interfaz de usuario.
En este tema se proporciona información sobre la compatibilidad de automatización de la interfaz de usuario con el tipo de control Tree. 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 del árbol de automatización de la interfaz de usuario, los valores de las propiedades de automatización de la interfaz de usuario y los patrones de control.
El tipo de control Tree se usa para contenedores cuyo contenido tiene relevancia como jerarquía de nodos, al igual que con la forma en que se muestran los archivos y carpetas en el panel izquierdo del Explorador de Microsoft Windows. 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 como expandidos o contraídos.
En las secciones siguientes se define la estructura de árbol de automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control Tree. 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 muestra la vista de control y la vista de contenido del árbol de automatización de la interfaz de usuario que pertenece a los controles de árbol y se describe lo que se puede contener 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 automatización de la interfaz de usuario consta de:
Desde cero hasta muchos elementos dentro del contenedor (los elementos pueden basarse en el elemento de árbol, el elemento de datos u otro tipo de control).
Cero, una o dos barras de desplazamiento.
La vista de contenido del árbol de automatización de la interfaz de usuario consta de cero o muchos elementos dentro del contenedor (los elementos se pueden basar en el elemento de á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 enumeran las propiedades de automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de lista. Para obtener 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 | Importancia | 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 de árbol tienen un punto en el que se puede hacer clic que hará que el árbol o uno de los elementos del contenedor de árbol tenga el foco establecido 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 | Cierto | El control de árbol siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| IsControlElementProperty | Cierto | 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 enumeran los patrones de control de automatización de la interfaz de usuario necesarios para ser compatibles con los controles de lista. Para obtener más información sobre los patrones de control, consulte Introducción a los patrones de control de automatización de la interfaz de usuario.
| 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 seleccionar un elemento no transmite información significativa al usuario. |
| CanSelectMultiple | Vea las notas. | Implemente esta propiedad si el control de árbol admite varias selecciones (la mayoría de los controles de árbol no admiten varias selecciones). |
| 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 enumeran los eventos de automatización de la interfaz de usuario necesarios para ser compatibles con 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 | Apoyo | Notas |
|---|---|---|
| InvalidatedEvent | Depende | Ninguno |
| Evento cambiado por propiedadBoundingRectangleProperty . | Obligatorio | Ninguno |
| Evento cambiado por propiedadIsOffscreenProperty . | Obligatorio | Ninguno |
| Evento cambiado por propiedadIsEnabledProperty . | Obligatorio | Ninguno |
| Evento cambiado por propiedadHorizontallyScrollableProperty . | Depende | Ninguno |
| Evento cambiado por propiedadHorizontalScrollPercentProperty . | Depende | Ninguno |
| Evento cambiado por propiedadHorizontalViewSizeProperty . | Depende | Ninguno |
| Evento cambiado por propiedadVerticalScrollPercentProperty . | Depende | Ninguno |
| Evento cambiado por propiedadVerticallyScrollableProperty . | Depende | Ninguno |
| Evento cambiado por propiedadVerticalViewSizeProperty . | Depende | Ninguno |
| AutomationFocusChangedEvent | Obligatorio | Ninguno |
| StructureChangedEvent | Obligatorio | Ninguno |