macro TreeView_CreateDragImage (commctrl.h)

Crea una bitmap di trascinamento per l'elemento specificato in un controllo visualizzazione albero. La macro crea anche un elenco di immagini per la bitmap e aggiunge la bitmap all'elenco di immagini. Un'applicazione può visualizzare l'immagine quando si trascina l'elemento usando le funzioni dell'elenco di immagini. È possibile utilizzare questa macro o inviare il messaggio di TVM_CREATEDRAGIMAGE in modo esplicito.

Sintassi

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

Handle per l'elemento che riceve la nuova bitmap di trascinamento.

Valore restituito

Tipo: HIMAGELIST

Restituisce l'handle all'elenco di immagini a cui è stata aggiunta la bitmap di trascinamento in caso di esito positivo oppure null in caso contrario.

Osservazioni

Se si crea un controllo visualizzazione albero senza un elenco di immagini associato, non è possibile utilizzare la macro TreeView_CreateDragImage per creare l'immagine da visualizzare durante un'operazione di trascinamento. È necessario implementare un metodo personalizzato per creare un cursore di trascinamento.

L'applicazione è responsabile dell'eliminazione dell'elenco di immagini quando non è più necessaria.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h