Share via


DAD_SetDragImage-Funktion (shlobj_core.h)

[DAD_SetDragImage ist in Windows 2000 und Windows XP verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen ImageList_BeginDrag .]

Legt das Bild ziehen fest.

Syntax

BOOL DAD_SetDragImage(
  HIMAGELIST him,
  POINT      *pptOffset
);

Parameter

him

Typ: HIMAGELIST

Ein Handle für eine Bildliste. Dieser Parameter verwendet den Nullindex in der ImageList.

pptOffset

Typ: POINT*

Ein Zeiger auf die Koordinaten, die als Hotspot zum Ziehen des Bilds verwendet werden. Die Koordinaten sind relativ zur linken oberen Ecke des Bilds.

Rückgabewert

Typ: BOOL

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

Hinweise

Sie können das Ziehbild löschen, indem Sie den parameter him auf -1 und den pptOffset-Parameter auf NULLfestlegen. Das Bild muss innerhalb desselben Threads festgelegt worden sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.00 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)