Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Cada item em um controle de árvore (CTreeCtrl) pode ter um par de imagens bitmap associadas a ele. As imagens aparecem no lado esquerdo da etiqueta de um item. Uma imagem é exibida quando o item é selecionado e a outra é exibida quando o item não é selecionado. Por exemplo, um item pode exibir uma pasta aberta quando é selecionado e uma pasta fechada quando não está selecionado.
Para usar imagens de item, você deve criar uma lista de imagens construindo um objeto CImageList e usando a função CImageList::Create para criar a lista de imagens associada. Em seguida, adicione os bitmaps desejados à lista e associe a lista ao controlo de árvore usando a função membro SetImageList. Por padrão, todos os itens exibem a primeira imagem na lista de imagens para os estados selecionado e não selecionado. Você pode alterar o comportamento padrão para um item específico especificando os índices das imagens selecionadas e não selecionadas ao adicionar o item ao controle de árvore usando a função de membro InsertItem . Você pode alterar os índices depois de adicionar um item usando a função membro SetItemImage.
As listas de imagens de um controle de árvore também podem conter imagens de sobreposição, que são projetadas para serem sobrepostas a imagens de item. Um valor diferente de zero nos bits 8 a 11 do estado de um item de controle de árvore especifica o índice baseado em 1 de uma imagem de sobreposição (0 indica nenhuma imagem de sobreposição). Como um índice baseado em um de 4 bits é usado, as imagens de sobreposição devem estar entre as primeiras 15 imagens nas listas de imagens. Para obter mais informações sobre os estados do item de controle de árvore, consulte Visão geral dos estados do item de controle de árvore anteriormente neste tópico.
Se uma lista de imagens de estado for especificada, um controle de árvore reservará espaço à esquerda do ícone de cada item para uma imagem de estado. Um aplicativo pode usar imagens de estado, como caixas de seleção marcadas e desmarcadas, para indicar estados de item definidos pelo aplicativo. Um valor diferente de zero nos bits 12 a 15 especifica o índice baseado em um de uma imagem de estado (0 indica nenhuma imagem de estado).
Ao especificar o valor I_IMAGECALLBACK em vez do índice de uma imagem, você pode atrasar a especificação da imagem selecionada ou não selecionada até que o item esteja prestes a ser redesenhado. I_IMAGECALLBACK orienta o controlo de árvore a consultar a aplicação pelo índice ao enviar a mensagem de notificação TVN_GETDISPINFO.
A função membro GetImageList recupera o handle da lista de imagens de um controlo de árvore. Esta função é útil se você precisar adicionar mais imagens à lista. Para obter mais informações sobre listas de imagens, consulte Usando CImageList, CImageList na referência MFC e Listas de imagens no SDK do Windows.