CTreeCtrl::MapItemToAccID
Mappe le handle spécifié d'un élément d'arborescence dans le contrôle arborescence actuel à un identificateur d'accessibilité.
UINT MapItemToAccID(
HTREEITEM hItem
) const;
Paramètres
Paramètre |
Description |
|---|---|
[in] hItem |
Un handle d'un élément d'arborescence dans le contrôle. Pour plus d'informations, consultez le membre d' hItem de la structure de TVITEMEX . |
Valeur de retour
L'identificateur d'accessibilité qui correspond au paramètre d' hItem .
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_MAPHTREEITEMTOACCID , 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 obtient un numéro d'identification d'un élément de contrôle arborescence. 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. Cet exemple de code obtient un seul numéro d'identification du nœud de pays/région racine.
// Map an accessibility identifier to the Pennsylvania node.
accIdUS = m_treeCtrl.MapItemToAccId( hCountry );