Tipo de control tree
En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Tree.
El tipo de control Árbol 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 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 expandidos o contraídos. El control de vista de árbol de Windows (identificado por WC_TREEVIEW) es un ejemplo de un control que pertenece al tipo de control Tree .
En las secciones siguientes se definen la estructura de árbol 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 elementos de árbol en los que el marco o la plataforma de la interfaz de usuario se integra Automatización de la interfaz de usuario compatibilidad con los tipos de control y los patrones de control.
En este tema se incluyen las siguientes secciones.
- Estructura de árbol típica
- Propiedades pertinentes
- Patrones de control necesarios
- Eventos necesarios
- Temas relacionados
Estructura de árbol típica
En la tabla siguiente se muestra un control típico y una 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 UI Automation, vea Información general del árbol de UI Automation.
| Vista de control | Vista de contenido |
|---|---|
|
|
La vista de control del árbol de UI Automation consta de:
- Cero de muchos elementos dentro del contenedor (los elementos se pueden basar en los tipos de control TreeItem o DataItem ).
- Cero, uno o dos controles de barra 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 los tipos de control TreeItem o DataItem).
Propiedades pertinentes
En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para el tipo de control Tree. Para obtener más información sobre las propiedades de Automatización de la interfaz de usuario, vea Recuperar propiedades de Automatización de la interfaz de usuario Elements.
| Propiedad de automatización de interfaz de usuario | Valor | Notas |
|---|---|---|
| UIA_AutomationIdPropertyId | Vea las notas. | El valor de esta propiedad debe ser único entre todos los elementos del mismo nivel en la vista sin procesar del árbol de Automatización de la interfaz de usuario. |
| UIA_BoundingRectanglePropertyId | Vea las notas. | El rectángulo exterior que contiene el control completo. |
| UIA_ClickablePointPropertyId | Vea las notas. | Los controles de árbol tienen un punto en el que se puede hacer clic que hace que el árbol o uno de los elementos del contenedor de árbol reciba el foco. Un control de árbol puede tener un punto en el que se puede hacer clic solo si es posible hacer clic en una ubicación en el árbol sin hacer que se seleccione un elemento o para recibir el foco. |
| UIA_ControlTypePropertyId | Árbol | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| UIA_IsContentElementPropertyId | TRUE | El control de árbol siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| UIA_IsControlElementPropertyId | TRUE | El control de árbol siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario. |
| UIA_IsKeyboardFocusablePropertyId | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| UIA_LabeledByPropertyId | Vea las notas. | Si el control de árbol tiene una etiqueta asociada, esta propiedad devuelve un puntero IUIAutomationElement para esa etiqueta. De lo contrario, la propiedad devuelve una referencia nula. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada correspondiente al tipo de control Tree . El valor predeterminado es "tree" para en-US o inglés (Estados Unidos). |
| UIA_NamePropertyId | 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, debe proporcionar un valor para esta propiedad. |
Patrones de control necesarios
En la tabla siguiente se enumeran los patrones de control Automatización de la interfaz de usuario que todos los controles de árbol deben admitir. 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 |
|---|---|---|
| IScrollProvider | Depende | Implemente el patrón de control Scroll si se pueden desplazar los elementos del contenedor de árbol. |
| ISelectionProvider | Depende | Los controles de árbol que contienen un conjunto de elementos seleccionables deben implementar el patrón de control Selección . No es necesario implementarlo 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. |
Eventos necesarios
En la tabla siguiente se enumeran los eventos Automatización de la interfaz de usuario que todos los controles de árbol deben admitir. Para más información sobre los eventos, vea UI Automation Events Overview.
| Evento de Automatización de la interfaz de usuario | Notas |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento de cambio de propiedad. | |
| UIA_IsEnabledPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsEnabled , debe admitir este evento. |
| UIA_IsOffscreenPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsOffscreen , debe admitir este evento. |
| UIA_ScrollHorizontallyScrollablePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_ScrollVerticalViewSizePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Scroll , debe admitir este evento. |
| UIA_Selection_InvalidatedEventId | Si el control admite el patrón de control Selection , debe admitir este evento. |
| UIA_StructureChangedEventId |
Temas relacionados
-
Conceptual
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de