CTreeCtrl::MapAccIdToItem
Ordnet den angegebenen Barrierefreiheitsbezeichner dem Handle eines Strukturansichtelements im aktuellen Strukturansicht zu.
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
Parameter
Parameter |
Description |
|---|---|
[in] uAccId |
Ein Barrierefreiheitsbezeichner für ein Element im Strukturansichtelement. |
Rückgabewert
Das Handle für ein Strukturansichtelement (HTREEITEM) das dem uAccId-Parameter entspricht. Weitere Informationen finden Sie im hItem-Member der TVITEMEX-Struktur.
Hinweise
Hilfstechnologien sind Anwendungen, die Personen mit Behinderungen helfen, Computer zu verwenden. Ein Barrierefreiheitsbezeichner wird durch die IAccessible-Schnittstelle verwendet, um ein Element in einem Fenster eindeutig anzugeben. Weitere Informationen zu Barrierefreiheitsbezeichner, Suche für das "über Active Accessibility-Stütz" Thema an Microsoft Developer Network.
Diese Methode sendet die TVM_MAPACCIDTOHTREEITEM Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxcmn.h
Diese Methode wird in Windows XP und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Anforderungen für die Erstellung von Windows Vista-Standardsteuerelementen beschrieben.
Beispiel
Im folgenden Codebeispiel wird eine Variable, m_treeCtrl, die verwendet wird, um auf das aktuelle Strukturansicht zuzugreifen. Im Codebeispiel wird auch eine ganze Zahl ohne Vorzeichen und einige HTREEITEM-Variablen. Diese Variablen werden im folgenden Beispiel verwendet.
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;
Im folgenden Beispielcode wird ein Barrierefreiheitsbezeichner und die CTreeCtrl::MapAccIdToItem-Methode, um ein Handle für Stammstrukturansichtelement abzurufen. Im Beispiel wird das Handle und die CTreeCtrl::GetItemPartRect-Methode, um ein 3D-Rechteck um das Element zu zeichnen. In einem früheren Abschnitt des Codebeispiels, das nicht angezeigt wird, haben wir eine Strukturansicht, die aus einem Stammland/regions-Knoten für USA, untergeordnete Knoten für die Pennsylvania und Staat Washington besteht, und Strukturelemente für Orte in diesen Zuständen. Wir haben die CTreeCtrl::MapItemToAccID-Methode, um das Stammstrukturansichtelement mit einem Barrierefreiheitsbezeichner zuzuordnen.
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));