Compartir a través de


macro TreeView_CreateDragImage (commctrl.h)

Crea un mapa de bits de arrastre para el elemento especificado en un control de vista de árbol. La macro también crea una lista de imágenes para el mapa de bits y agrega el mapa de bits a la lista de imágenes. Una aplicación puede mostrar la imagen al arrastrar el elemento mediante las funciones de lista de imágenes. Puede usar esta macro o enviar el mensaje TVM_CREATEDRAGIMAGE explícitamente.

Sintaxis

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

hitem

Tipo: HTREEITEM

Controle al elemento que recibe el nuevo mapa de bits de arrastre.

Valor devuelto

Tipo: HIMAGELIST

Devuelve el identificador de la lista de imágenes a la que se agregó el mapa de bits de arrastre si se ejecuta correctamente o NULL de lo contrario.

Observaciones

Si crea un control de vista de árbol sin una lista de imágenes asociada, no puede usar la macro TreeView_CreateDragImage para crear la imagen que se va a mostrar durante una operación de arrastre. Debe implementar su propio método para crear un cursor de arrastre.

La aplicación es responsable de destruir la lista de imágenes cuando ya no es necesaria.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de commctrl.h