Share via

Control de vista de árbol (referencia de elemento de interfaz de usuario de MSAA)

  • Artículo

Nota:

En este tema se describen los objetos Tree View Control con fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear objetos de control de vista de árbol 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 la 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 IAccessible :

Método Comentarios
accDoDefaultAction El propio objeto de vista de árbol no tiene un método accDoDefaultAction . Dependiendo de la propiedad State de un elemento en la vista de árbol, accDoDefaultAction expande o contrae el elemento especificado.
accHitTest
accLocation
accNavigate
accSelect

Propiedades IAccessible

Un control de vista de árbol admite las siguientes propiedades IAccessible :

Propiedad Comentarios
get_accChild
get_accChildCount La propiedad ChildCount del 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 "Collapse" 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 subtí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 la misma propiedad Name y el mismo 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 RoleROLE_SYSTEM_OUTLINE. Cada elemento de la vista de árbol tiene la propiedad RoleROLE_SYSTEM_OUTLINEITEM.
get_accSelection
get_accState La propiedad State de la vista de árbol es una combinación de uno o varios de los valores siguientes: STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
Para los elementos de vista de árbol, la propiedad State incluye STATE_SYSTEM_EXPANDED o STATE_SYSTEM_COLLAPSED.
Entre los valores posibles adicionales para la propiedad State se 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.

IAccessible (interfaz)