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