CTreeCtrl::MapAccIdToItem

Articolo
02/19/2013

Esegue il mapping l'identificatore specificato di accessibilità a un handle di un elemento di visualizzazione struttura ad albero nel controllo di visualizzazione ad albero corrente.

HTREEITEM MapAccIdToItem(
          UINT uAccId
) const;

Parametri

Parametro	Descrizione
[in] uAccId	Un identificatore di accessibilità per un elemento dell'elemento della visualizzazione struttura ad albero.

Valore restituito

Handle a un elemento di visualizzazione struttura ad albero (HTREEITEM) che corrisponde al parametro uAccId.Per ulteriori informazioni, vedere il membro hItem della struttura TVITEMEX.

Note

Gli strumenti per l'accesso facilitato sono applicazioni che consentono agli utenti con particolari esigenze di utilizzare i computer.Un identificatore di accessibilità utilizzato dall'interfaccia IAccessible in modo univoco per specificare un elemento in una finestra.Per ulteriori informazioni sugli identificatori di accessibilità, cercare “sull'argomento del supporto per l'accessibilità attivo„ in Microsoft Developer Network.

Questo metodo invia il messaggio TVM_MAPACCIDTOHTREEITEM, come descritto in Windows SDK.

Requisiti

intestazione: afxcmn.h

Questo metodo è supportato in Windows XP e versioni successive.

i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.

Esempio

Nell'esempio di codice definisce una variabile, m_treeCtrl, utilizzata per accedere al controllo di visualizzazione ad albero corrente.L'esempio di codice definisce inoltre un intero senza segno e più variabili di HTREEITEM.Queste variabili vengono utilizzate nell'esempio seguente.

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;

Nell'esempio di codice seguente viene utilizzato un identificatore di accessibilità e il metodo CTreeCtrl::MapAccIdToItem per recuperare l'handle l'elemento radice di visualizzazione struttura ad albero.L'esempio utilizza l'handle e il metodo CTreeCtrl::GetItemPartRect per disegnare un rettangolo tridimensionale intorno a questo elemento.In una sezione precedente dell'esempio di codice, non viene visualizzato, creato una visualizzazione struttura ad albero che include un nodo radice area a un paese per gli Stati Uniti, sottonodi degli stati di Pensilvania e di Washington e gli elementi albero delle città negli stati.È stato utilizzato il metodo CTreeCtrl::MapItemToAccID per associare l'elemento radice di visualizzazione struttura ad albero con un identificatore di 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));