TreeView_CreateDragImage Makro (commctrl.h)

Erstellt eine Ziehbitmap für das angegebene Element in einem Strukturansicht-Steuerelement. Das Makro erstellt außerdem eine Bildliste für die Bitmap und fügt die Bitmap der Bildliste hinzu. Eine Anwendung kann das Bild beim Ziehen des Elements mithilfe der Bildlistenfunktionen anzeigen. Sie können dieses Makro verwenden oder die TVM_CREATEDRAGIMAGE Nachricht explizit senden.

Syntax

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM-

Behandeln Sie das Element, das die neue Ziehbitmap empfängt.

Rückgabewert

Typ: HIMAGELIST

Gibt den Ziehpunkt an die Bildliste zurück, zu der die Ziehbitmap hinzugefügt wurde, falls dies erfolgreich war, oder NULL- andernfalls.

Bemerkungen

Wenn Sie ein Strukturansicht-Steuerelement ohne eine zugeordnete Bildliste erstellen, können Sie das TreeView_CreateDragImage Makro nicht verwenden, um das Bild während eines Ziehvorgangs anzuzeigen. Sie müssen ihre eigene Methode zum Erstellen eines Ziehcursors implementieren.

Ihre Anwendung ist dafür verantwortlich, die Bildliste zu zerstören, wenn sie nicht mehr benötigt wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h