CTreeCtrl::MapAccIdToItem
Asigna el identificador especificado de accesibilidad en el identificador de un elemento de vista de árbol del control de vista de árbol actual.
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
Parámetros
Parámetro |
Descripción |
|---|---|
[in] uAccId |
Un identificador de accesibilidad para un elemento en el elemento de vista de árbol. |
Valor devuelto
El identificador a un elemento de vista de árbol (HTREEITEM) que corresponde a uAccId el parámetro.Para obtener más información, vea el miembro hItem de la estructura TVITEMEX .
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_MAPACCIDTOHTREEITEM , 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 la compilación para 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 utiliza un identificador de accesibilidad y el método CTreeCtrl::MapAccIdToItem para recuperar un identificador al elemento de vista de árbol de la raíz.El ejemplo utiliza el identificador y el método CTreeCtrl::GetItemPartRect para dibujar un rectángulo 3D alrededor de ese elemento.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.Se utiliza el método CTreeCtrl::MapItemToAccID para asociar el elemento de vista de árbol con un identificador de accesibilidad.
CRect rect;
HTREEITEM hUS = m_treeCtrl.MapAccIdToItem( accIdUS );
m_treeCtrl.GetItemPartRect( hUS, TVGIPR_BUTTON, &rect );
m_treeCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(0, 0, 255));