Control de vista de árbol (referencia de elementos de interfaz de usuario de MSAA)
Nota
En este tema se describen control de vista de árbol objetos para fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear control de vista de árbol objetos en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.
Un control de vista de árbol muestra una lista jerárquica de elementos mediante líneas para conectar elementos relacionados en una jerarquía. Cada elemento consta de una etiqueta y un mapa de bits opcional. El Explorador de Windows usa un control de vista de árbol para mostrar directorios.
El nombre de clase de ventana de un control de vista de árbol es WC_TREEVIEW, que se define como "SysTreeView" en Commctrl.h.
Métodos IAccessible
Un control de vista de árbol admite los siguientes métodos deIAccessible:
| Método | Comentarios |
|---|---|
| accDoDefaultAction | El propio objeto de vista de árbol no tiene un método accDoDefaultAction. Según la propiedad State de de un elemento de la vista de árbol, accDoDefaultAction expande o contrae el elemento especificado. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propiedades de IAccessible
Un control de vista de árbol admite las siguientes propiedades deIAccessible:
| Propiedad | Comentarios |
|---|---|
| get_accChild | |
| get_accChildCount | La propiedad ChildCount para el objeto de vista de árbol es el número de elementos contenidos en la vista de árbol. La propiedad ChildCount para cada elemento de vista de árbol es cero. |
| get_accDefaultAction | El propio objeto de vista de árbol no tiene una propiedad DefaultAction. Un elemento de la vista de árbol que se expande tiene "Contraer" como su propiedad DefaultAction, y un elemento que no está expandido tiene "Expand" como su propiedad DefaultAction. |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | |
| get_accName | La propiedad Name del objeto de vista de árbol se obtiene del texto de la ventana del control (o título). Este texto no se muestra con el control de vista de árbol, por lo que los desarrolladores de servidores deben proporcionar texto significativo en la instrucción de definición de recursos del control para ayudar a los usuarios de utilidades de cliente a identificar el control. La propiedad Name de un elemento de la vista de árbol es el texto que se muestra en el elemento de vista de árbol. |
| get_accParent | La propiedad Parent del objeto de vista de árbol es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el control y tiene el mismo Nombre propiedad y nombre de clase de ventana que el control. La propiedad Parent de cada elemento de la vista de árbol es el objeto de vista de árbol. |
| get_accRole | El objeto de vista de árbol tiene la propiedad role ROLE_SYSTEM_OUTLINE. Cada elemento de la vista de árbol tiene la propiedad RoleROLE_SYSTEM_OUTLINEITEM. |
| get_accSelection | |
| get_accState | La propiedad state para la vista de árbol es una combinación de uno o varios de los siguientes valores de : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE Para los elementos de la vista de árbol, la propiedad state incluye STATE_SYSTEM_EXPANDED o STATE_SYSTEM_COLLAPSED. Los valores posibles adicionales para la propiedad State de incluyen: STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED |
| get_accValue | El objeto de vista de árbol no tiene un valor. La propiedad Value para cada elemento de vista de árbol es el nivel de sangría del elemento de la jerarquía. Por ejemplo, en el Explorador de Windows, el elemento "Escritorio" tiene una propiedad Value de "0"; el elemento "Mi computadora", que se encuentra en el siguiente nivel de la jerarquía, tiene una propiedad Value de "1"; y cada una de las unidades de disco, que se encuentran en el siguiente nivel de la jerarquía, tienen una propiedad Value de "2". |
Notas
La propiedad accLocation de los elementos de vista de árbol devuelve la ubicación solo del texto del elemento. Las coordenadas devueltas por accLocation para los elementos de vista de árbol no incluyen el icono situado a la izquierda del texto.