Freigeben über


CTreeCtrl::MapItemToAccID

Ordnet das angegebene Handle eines Strukturansichtelements im aktuellen Strukturansicht zu einem Barrierefreiheitsbezeichner zu.

UINT MapItemToAccID(
     HTREEITEM hItem
) const;

Parameter

Parameter

Description

[in] hItem

Ein Handle eines Strukturansichtelements im - Steuerelement.Weitere Informationen finden Sie im hItem-Member der TVITEMEX-Struktur.

Rückgabewert

Der Barrierefreiheitsbezeichner, der dem hItem-Parameter entspricht.

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_MAPHTREEITEMTOACCID 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 Build-Anforderungen für Windows Vista-gemeinsame Regelungen 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 Codebeispiel wird eine ID für ein Strukturansicht-Steuerelement-Element.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.Dieses Codebeispiel ruft eine eindeutige ID für den Stammland/regions-Knoten.

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

Siehe auch

Referenz

CTreeCtrl-Klasse

Hierarchien-Diagramm

TVM_MAPHTREEITEMTOACCID

TVITEMEX

CTreeCtrl::MapAccIdToItem