macro TreeView_CreateDragImage (commctrl.h)

Crée une bitmap de glissement pour l’élément spécifié dans un contrôle d’arborescence. La macro crée également une liste d’images pour la bitmap et ajoute la bitmap à la liste d’images. Une application peut afficher l’image lors du glissement de l’élément à l’aide des fonctions de liste d’images. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_CREATEDRAGIMAGE.

Syntaxe

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

hitem

Type : HTREEITEM

Handle to the item that receive the new dragging bitmap.

Valeur de retour

Type : HIMAGELIST

Retourne la poignée de la liste d’images à laquelle l’image bitmap de glissement a été ajoutée en cas de réussite, ou null sinon.

Remarques

Si vous créez un contrôle d’arborescence sans liste d’images associée, vous ne pouvez pas utiliser la macro TreeView_CreateDragImage pour créer l’image à afficher pendant une opération de glisser. Vous devez implémenter votre propre méthode de création d’un curseur glisser.

Votre application est responsable de la destruction de la liste d’images lorsqu’elle n’est plus nécessaire.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h