CTreeCtrl::MapAccIdToItem
Mapeia o identificador especificado de acessibilidade para o identificador de um item de modo de exibição em árvore do controle atual do modo de exibição de árvore.
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
Parâmetros
Parâmetro |
Descrição |
---|---|
[in] uAccId |
Um identificador de acessibilidade para um elemento item no modo de exibição de árvore. |
Valor de retorno
O identificador a um item de modo de exibição de árvore (HTREEITEM) que corresponde ao parâmetro de uAccId .Para obter mais informações, consulte o membro de hItem estrutura de TVITEMEX .
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_MAPACCIDTOHTREEITEM , 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 usa um identificador de acessibilidade e o método de CTreeCtrl::MapAccIdToItem para recuperar uma alça ao item de modo de exibição de árvore raiz.O exemplo usa o identificador e o método de CTreeCtrl::GetItemPartRect para desenhar um retângulo 3D em torno do item.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.Usamos o método de CTreeCtrl::MapItemToAccID para associar o item de modo de exibição de árvore raiz com um identificador de acessibilidade.
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));