CTreeCtrl::MapAccIdToItem
Mapeia o identificador da acessibilidade especificada para a alça de um item de exibição em árvore no controle de exibição em árvore corrente.
HTREEITEM MapAccIdToItem(
UINT uAccId
) const;
Parâmetros
Parâmetro |
Descrição |
|---|---|
[in] uAccId |
Um identificador de acessibilidade de um elemento no item de exibição em árvore. |
Valor de retorno
O identificador para um item de modo de exibição de árvore (HTREEITEM) que corresponde à uAccId parâmetro. Para obter mais informações, consulte o hItem membro de TVITEMEX estrutura.
Comentários
recursos de acessibilidade são aplicativos que ajudam as pessoas com deficiências usam computadores.Um identificador de acessibilidade é usado pelo IAccessible interface para especificar de forma exclusiva um elemento em uma janela. Para obter mais informações sobre identificadores de acessibilidade, procure o tópico "Sobre ativo Accessibility suporte" noMicrosoft Developer rede.
Esse método envia o TVM_MAPACCIDTOHTREEITEM mensagem, que é descrita no Windows SDK.
Requisitos
Cabeçalho: afxcmn.h
Este método é suportado no Windows XP e posterior.
Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.
Exemplo
O exemplo de código a seguir define uma variável, m_treeCtrl, que é usado para acessar o controle de exibição em árvore corrente. O exemplo de código também define um inteiro sem sinal e HTREEITEM diversas variáveis.Essas variáveis são usadas 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 CTreeCtrl::MapAccIdToItem método para recuperar um identificador para o item de exibição em árvore raiz. O exemplo usa o identificador e o CTreeCtrl::GetItemPartRect método para desenhar um retângulo ao redor desse item 3D. Em uma seção anterior do exemplo de código, que não é exibido, criamos uma exibição de árvore que consiste em um nó raiz Country dos Estados Unidos, subnós para os estados da Pensilvânia e Washington e itens da árvore para cidades nesses estados.Usamos o CTreeCtrl::MapItemToAccID método para associar o item de exibição em á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));