Compartilhar via


CTreeCtrl::MapItemToAccID

Mapeia a alça especificada de um item de modo de exibição em árvore do controle atual do modo de exibição de árvore para um identificador de acessibilidade.

UINT MapItemToAccID(
     HTREEITEM hItem
) const;

Parâmetros

Parâmetro

Descrição

[in] hItem

Uma alça de um item de modo de exibição em árvore do controle.Para obter mais informações, consulte o membro de hItem estrutura de TVITEMEX .

Valor de retorno

O identificador de acessibilidade que corresponde ao parâmetro de hItem .

Comentários

Os recursos de acessibilidade são aplicativos que ajudam pessoas com deficiências a usarem computadores.Um identificador de acessibilidade é usado pela interface de IAccessible exclusivamente para especificar um elemento em uma janela.Para obter mais informações sobre identificadores de acessibilidade, pesquisa para “no tópico de ativa suporte de acessibilidade” em Microsoft developer network.

este método envia a mensagem de TVM_MAPHTREEITEMTOACCID , que é descrita em Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Este método é suportado no Windows XP e posteriormente.

Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define uma variável, m_treeCtrl, que é usada para acessar o controle atual do modo de exibição de árvore.O exemplo de código também define um inteiro sem sinal e diversas variáveis de HTREEITEM.Essas variáveis são usados no exemplo a seguir.

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;

O exemplo de código a seguir obtém um número de identificação de um item de controle de exibição de árvore.Em uma seção anterior do exemplo de código, que não é mostrado, nós criaremos um modo de exibição de árvore que consistisse em um país/nó raiz para o Estados Unidos, subnodes da região para os estados de Pensilvânia e de Washington, e itens da árvore para cidades nos estados.Este exemplo de código a seguir obtém um número de identificação exclusiva para o país/nó raiz da região.

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

Consulte também

Referência

Classe de CTreeCtrl

Gráfico de hierarquia

TVM_MAPHTREEITEMTOACCID

TVITEMEX

CTreeCtrl::MapAccIdToItem