TreeView_CreateDragImage Makro (commctrl.h)

  • Artikel

Erstellt eine Bitmap zum Ziehen für das angegebene Element in einem Strukturansichtssteuerelement. Das Makro erstellt auch 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

void TreeView_CreateDragImage(
   hwnd,
   hitem
);

Parameter

hwnd

Typ: HWND

Handle für das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM

Handle für das Element, das die neue Bitmap zum Ziehen empfängt.

Rückgabewert

Keine

Bemerkungen

Wenn Sie ein Strukturansichtssteuerelement ohne zugeordnete Bildliste erstellen, können Sie das makro TreeView_CreateDragImage nicht verwenden, um das Bild zu erstellen, das während eines Ziehvorgangs angezeigt werden soll. Sie müssen eine 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
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h