CTreeCtrl::SetItemExpandedImageIndex
Define o índice da imagem para exibir quando o item especificado do controle atual do modo de exibição de árvore está no estado expandido.
BOOL SetItemExpandedImageIndex(
HTREEITEM hItem,
int iExpandedImage
);
Parâmetros
Parâmetro |
Descrição |
|---|---|
[in] hItem |
Manipular a um item de controle de exibição de árvore. |
[in] iExpandedImage |
O índice da imagem para exibir quando o item especificado está no estado expandido. |
Valor de retorno
true se este método é com êxito; caso contrário, false.
Comentários
este método envia a mensagem de TVM_SETITEM , que é descrita em Windows SDK. Este método define o parâmetro de iExpandedImage ao membro de iExpandedImage de uma estrutura de TVITEMEX , e então utiliza o estrutura na mensagem.
Requisitos
Cabeçalho: afxcmn.h
este método é suportado em Windows Vista 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 é um teste trivial para determinar se o método de CTreeCtrl::GetItemExpandedImageIndex retorna o valor definido pelo método de CTreeCtrl::SetItemExpandedImageIndex .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.
CString str;
CString msg = _T("The set and retrieved item expanded image ")
_T("indexes are%s equal.");
int nSetItem = 0;
m_treeCtrl.SetItemExpandedImageIndex( hCountry, nSetItem );
int nItem = m_treeCtrl.GetItemExpandedImageIndex( hCountry );
if (nItem == nSetItem)
str.Format(msg, _T(""));
else
str.Format(msg, _T(" not"));
AfxMessageBox(str, MB_ICONINFORMATION);