TreeView_CreateDragImage macro (commctrl.h)

Cria um bitmap arrastando para o item especificado em um controle de exibição de árvore. A macro também cria uma lista de imagens para o bitmap e adiciona o bitmap à lista de imagens. Um aplicativo pode exibir a imagem ao arrastar o item usando as funções de lista de imagens. Você pode usar essa macro ou enviar a mensagem TVM_CREATEDRAGIMAGE explicitamente.

Sintaxe

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Parâmetros

hwnd

Tipo: HWND

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

hitem

Tipo: HTREEITEM

Manipule para o item que recebe o novo bitmap de arrastar.

Valor de retorno

Tipo: HIMAGELIST

Retorna o identificador para a lista de imagens à qual o bitmap de arrastar foi adicionado se bem-sucedido ou NULL caso contrário.

Observações

Se você criar um controle de exibição de árvore sem uma lista de imagens associada, não poderá usar a macro TreeView_CreateDragImage para criar a imagem a ser exibida durante uma operação de arrastar. Você deve implementar seu próprio método de criação de um cursor de arrastar.

Seu aplicativo é responsável por destruir a lista de imagens quando ela não é 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