Compatibilidad de automatización de la interfaz de usuario con el tipo de control TreeItem

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 TreeItem. En automatización de la interfaz de usuario, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la ControlTypeProperty propiedad . Las condiciones incluyen directrices específicas para la estructura de árboles de automatización de la interfaz de usuario, los valores de propiedad y los patrones de control de automatización de la interfaz de usuario.

El tipo de control TreeItem representa un nodo dentro de un contenedor de árbol. Cada nodo puede 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 TreeItem. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de elementos 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 elementos de árbol y se describe lo que se puede contener en cada vista. Para obtener 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
TreeItem - CheckBox (0 o 1) - Imagen (0 o 1) - Botón (0 o 1) - TreeItem (0 o más)	TreeItem - TreeItem (0 o más)

Los controles de elementos de árbol pueden tener cero o más elementos de árbol secundarios en la vista de contenido del árbol de automatización de la interfaz de usuario. Si el control de elementos de árbol tiene funcionalidad más allá de lo que se expone en los patrones de control que se enumeran a continuación, el control debe basarse en el tipo de control Elemento de datos.

Los elementos del árbol contraídos no se mostrarán en la vista de control ni en la vista de contenido hasta que estén visibles y expandidos (o se pueden desplazar en la vista).

La vista de control puede contener detalles adicionales para un control, incluida una imagen asociada o un botón. Por ejemplo, un elemento de una vista de esquema puede contener una imagen, así como un botón para expandir o contraer el esquema. Estos objetos de detalle no aparecen en la vista de contenido porque la información ya está representada por el elemento de árbol primario. Los elementos de árbol que se desplazan fuera de la pantalla aparecerán en las vistas de control y de contenido del árbol de Automatización de la interfaz de usuario y deben tener IsOffscreenProperty establecida en true.

Propiedades necesarias de automatización de la interfaz de usuario

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.

Ui Automation (propiedad)	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.	Rectángulo más externo que contiene todo el control.
ClickablePointProperty	Vea las notas.	Esta propiedad debe devolver la ubicación del elemento que provocará que el elemento cambie su estado de selección o quede enfocado.
ControlTypeProperty	TreeItem	Este valor es el mismo para todos los marcos de interfaz de usuario.
IsContentElementProperty	Cierto	El control de lista siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
IsControlElementProperty	Cierto	El control de lista siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.
IsOffscreenProperty	Vea las notas.	Esta propiedad se establece para indicar cuando un control de elemento de árbol se desplaza fuera de la pantalla.
IsKeyboardFocusableProperty	Vea las notas.	Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
ItemTypeProperty	Vea las notas.	Si el control de elemento de árbol usa un icono visual para indicar que es un tipo determinado de objeto, se debe admitir esta propiedad e indicar cuál es el objeto.
LabeledByProperty	Null	Los controles de elementos de árbol son autoetitiquetes.
LocalizedControlTypeProperty	"elemento de árbol"	Cadena localizada correspondiente al tipo de control TreeItem.
NameProperty	Vea las notas.	Esta propiedad expone el texto mostrado para cada control de elemento de árbol.

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 pattern	Compatibilidad/valor	Notas
IInvokeProvider	Depende	Implemente este patrón de control si el elemento de árbol tiene un comando independiente y accionable.
IExpandCollapseProvider	Sí	Todos los elementos del árbol se pueden expandir o contraer.
ExpandCollapseState	Nodo expandido, contraído o hoja	Los elementos de árbol serán nodos hoja cuando no se expandan ni contraigan.
IScrollItemProvider	Depende	Implemente este patrón de control si el contenedor de árbol admite el patrón de control Scroll.
ISelectionItemProvider	Depende	Implemente este patrón de control si es posible tener una selección activa que se mantiene cuando el usuario vuelve al contenedor de árbol.
SelectionContainer	Sí	Esta propiedad expondrá el mismo contenedor para todos los elementos de dentro del contenedor.
IToggleProvider	Depende	Implemente este patrón de control si el elemento de árbol tiene una casilla asociada.

Eventos necesarios de automatización de la interfaz de usuario

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 elementos de árbol. Para obtener más información sobre los eventos, consulte UI Automation Events Overview.

Evento de automatización de la interfaz de usuario	Apoyo	Notas
AutomationFocusChangedEvent	Obligatorio	Ninguno
Evento de cambio de propiedad BoundingRectangleProperty.	Obligatorio	Ninguno
Evento de cambio de propiedad IsEnabledProperty.	Obligatorio	Ninguno
Evento de cambio de propiedad IsOffscreenProperty.	Obligatorio	Ninguno
Evento de cambio de propiedad ItemStatusProperty.	Depende	Ninguno
Evento de cambio de propiedad NameProperty.	Obligatorio	Ninguno
StructureChangedEvent	Obligatorio	Ninguno
Evento de cambio de propiedad ExpandCollapseStateProperty.	Obligatorio	Ninguno
InvokedEvent	Depende	Ninguno
Evento de cambio de propiedad CurrentViewProperty.	Depende	Ninguno
ElementAddedToSelectionEvent	Depende	Ninguno
ElementRemovedFromSelectionEvent	Depende	Ninguno
ElementSelectedEvent	Depende	Ninguno
Evento de cambio de propiedad ToggleStateProperty.	Depende	Ninguno
Evento de cambio de propiedad ValueProperty.	Depende	Ninguno

Consulte también

• TreeItem
• Introducción a los tipos de control de automatización de la interfaz de usuario de
• información general de automatización de la interfaz de usuario de