Compartir a través de


CTreeCtrl::MapItemToAccID

Asigna el identificador especificado de un elemento de vista de árbol del control de vista de árbol actual en un identificador de accesibilidad.

UINT MapItemToAccID(
     HTREEITEM hItem
) const;

Parámetros

Parámetro

Descripción

[in] hItem

El identificador de un elemento de vista de árbol del control. Para obtener más información, vea el miembro hItem de la estructura TVITEMEX .

Valor devuelto

El identificador de accesibilidad que corresponde a hItem el parámetro.

Comentarios

Las ayudas de accesibilidad son aplicaciones que ayudan a las personas con discapacidades a usar equipos. Un identificador de accesibilidad es utilizado por la interfaz IAccessible para especificar de forma exclusiva un elemento en una ventana. Para obtener más información sobre los identificadores de accesibilidad, busque “el tema de compatibilidad activo de accesibilidad About” en Microsoft Developer Network.

Este método envía el mensaje TVM_MAPHTREEITEMTOACCID , que se describe en Windows SDK.

Requisitos

Encabezado: afxcmn.h

Este método se admite en Windows XP y posterior.

Los requisitos adicionales para este método se describen en Requisitos de compilación para los controles comunes de Windows Vista.

Ejemplo

El ejemplo de código siguiente se define una variable, m_treeCtrl, que se utiliza para tener acceso al control de vista de árbol actual. El ejemplo de código también define un entero sin signo y varias variables de HTREEITEM. Estas variables se utilizan en el ejemplo siguiente.

public:
    // Variable to access tree control.
    CTreeCtrl m_treeCtrl;
    // Variable to access splitbutton control.
    CSplitButton m_splitbutton;
    // Accessibility identifier
    UINT accIdUS;
    // HTREEITEMs
    HTREEITEM hCountry;
    HTREEITEM hPA;
    HTREEITEM hWA;

El ejemplo de código siguiente se obtiene un número de identificación de un elemento del control de vista de árbol. En una sección anterior del ejemplo de código, que no se muestra, creamos una vista de árbol que consta de un nodo de país o región raíz para Estados Unidos, los subnodos para los estados de Pennsylvania y Washington, y los elementos de árbol para las ciudades de esos estados. Este ejemplo de código obtiene un identificador único para el nodo de país o región de la raíz.

   // Map an accessibility identifier to the Pennsylvania node.
    accIdUS = m_treeCtrl.MapItemToAccId( hCountry );

Vea también

Referencia

CTreeCtrl Class

Gráfico de jerarquías

TVM_MAPHTREEITEMTOACCID

TVITEMEX

CTreeCtrl::MapAccIdToItem