TreeView_SetImageList macro (commctrl.h)

  • Artigo

Define a lista de imagens normais ou de estado para um controle de exibição de árvore e redesenhe o controle usando as novas imagens. Você pode usar essa macro ou enviar a mensagem TVM_SETIMAGELIST explicitamente.

Sintaxe

HIMAGELIST TreeView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   INT        iImage
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle de exibição de árvore.

himl

Tipo: HIMAGELIST

O identificador HIMAGELIST para a lista de imagens. Se himl for NULL, a mensagem removerá a lista de imagens especificada do controle de exibição de árvore.

iImage

Tipo: INT

Tipo de lista de imagens a ser definida. Esse parâmetro pode ser um dos seguintes valores:

Valor Significado
TVSIL_NORMAL
 Indica a lista de imagens normal, que contém imagens selecionadas, não selecionadas e sobrepostas para os itens de um controle de exibição de árvore.
TVSIL_STATE
 Indica a lista de imagens de estado. Você pode usar imagens de estado para indicar estados de item definidos pelo aplicativo. Uma imagem de estado é exibida à esquerda da imagem selecionada ou não selecionada de um item.

Valor de retorno

Tipo: HIMAGELIST

Retorna o identificador HIMAGELIST para a lista de imagens anterior, se houver, ou NULL caso contrário.

Observações

O controle de exibição de árvore não destruirá a lista de imagens especificada com esta mensagem. Seu aplicativo deve destruir a lista de imagens quando ela não for mais necessária.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h

Consulte também

de referência de

TVM_GETIMAGELIST

TreeView_GetImageList