Share via


ImageList_BeginDrag-Funktion (commctrl.h)

Beginnt mit dem Ziehen eines Bilds.

Syntax

BOOL ImageList_BeginDrag(
  HIMAGELIST himlTrack,
  int        iTrack,
  int        dxHotspot,
  int        dyHotspot
);

Parameter

himlTrack

Typ: HIMAGELIST

Ein Handle für die Bildliste.

iTrack

Typ: int

Der Index des zu ziehenden Bilds.

dxHotspot

Typ: int

Die x-Koordinate der Position der Ziehposition relativ zur oberen linken Ecke des Bilds.

dyHotspot

Typ: int

Die y-Koordinate der Position der Ziehposition relativ zur oberen linken Ecke des Bilds.

Rückgabewert

Typ: BOOL

Gibt bei erfolgreicher Ausführung ungleich null zurück, andernfalls null.

Hinweise

Diese Funktion erstellt eine temporäre Bildliste, die zum Ziehen verwendet wird. Als Reaktion auf nachfolgende WM_MOUSEMOVE Nachrichten können Sie das Bild mithilfe der funktion ImageList_DragMove verschieben. Um den Ziehvorgang zu beenden, können Sie die funktion ImageList_EndDrag verwenden.

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
Bibliothek Comctl32.lib
DLL Comctl32.dll