CTreeCtrl::MapAccIdToItem
Mappe l'identificateur spécifié d'accessibilité au handle d'un élément d'arborescence dans le contrôle arborescence actuel.
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
Paramètres
Paramètre |
Description |
|---|---|
[in] uAccId |
Un identificateur d'accessibilité pour un élément dans l'élément d'arborescence. |
Valeur de retour
Le handle à un élément d'arborescence (HTREEITEM) qui correspond au paramètre d' uAccId . Pour plus d'informations, consultez le membre d' hItem de la structure de TVITEMEX .
Notes
Les outils d'accessibilité sont des applications que les personnes handicapées d'assistance utilisent des ordinateurs. Un identificateur d'accessibilité est utilisé par l'interface d' IAccessible pour spécifier qu'un élément dans une fenêtre. Pour plus d'informations sur les identificateurs d'accessibilité, recherchez la rubrique « concernant Active accessibilité de support » dans Microsoft Developer Network.
Cette méthode envoie le message de TVM_MAPACCIDTOHTREEITEM , qui est décrit dans Kit de développement logiciel Windows.
Configuration requise
en-tête : afxcmn.h
Cette méthode est prise en charge dans Windows XP et versions ultérieures.
Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications pour la génération des contrôles communs Windows Vista.
Exemple
l'exemple de code suivant définit une variable, m_treeCtrl, qui est utilisée pour accéder au contrôle arborescence actuel. l'exemple de code définit également un entier non signé et plusieurs variables de HTREEITEM. Ces variables sont utilisées dans l'exemple suivant.
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;
L'exemple de code suivant utilise un identificateur d'accessibilité et la méthode de CTreeCtrl::MapAccIdToItem pour récupérer un handle vers l'élément d'arborescence racine. L'exemple utilise le handle et la méthode de CTreeCtrl::GetItemPartRect pour dessiner un rectangle 3D autour de cet élément. Dans la première section de l'exemple de code, qui n'est pas indiqué, nous avons créé une arborescence qui se compose d'un nœud de pays/région racine pour les états-unis, sous-nœuds pour les états de la Pennsylvanie et de Washington, et les éléments d'arborescence pour les villes dans les rapports. Nous avons utilisé la méthode de CTreeCtrl::MapItemToAccID pour associer l'élément d'arborescence racine avec un identificateur d'accessibilité.
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));