CTreeCtrl::SetItemExpandedImageIndex

Artigo
08/25/2010

Define o índice da imagem a ser exibido quando o item especificado do controle corrente modo de exibição de árvore está no estado expandido.

BOOL SetItemExpandedImageIndex(
          HTREEITEM hItem, 
          int iExpandedImage
);

Parâmetros

Parâmetro	Descrição
[in] hItem	Identificador para um item de controle de exibição em árvore.
[in] iExpandedImage	O índice da imagem a ser exibido quando o item especificado está no estado expandido.

Valor de retorno

true Se esse método for bem-sucedida; caso contrário, false.

Comentários

Esse método envia o TVM_SETITEM mensagem, que é descrita no Windows SDK. Esse método atribui o iExpandedImage parâmetro para o iExpandedImage membro de um TVITEMEX estrutura e, em seguida, usa a estrutura da mensagem.

Requisitos

Cabeçalho: afxcmn.h

Este método é suportado no Windows Vista e mais recente.

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 é um teste simples para determinar se o CTreeCtrl::GetItemExpandedImageIndex método retorna o valor conjunto pela CTreeCtrl::SetItemExpandedImageIndex método. 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.

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