CTreeCtrl::SetItemExpandedImageIndex

Artigo
02/25/2013

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);