IImageList::GetDragImage-Methode (commoncontrols.h)

Ruft die temporäre Bildliste ab, die für das Ziehen des Bilds verwendet wird. Die Funktion ruft auch die aktuelle Ziehposition und den Offset des Ziehbilds relativ zur Ziehposition ab.

Syntax

HRESULT GetDragImage(
  [out] POINT  *ppt,
  [out] POINT  *pptHotspot,
  [out] REFIID riid,
  [out] void   **ppv
);

Parameter

[out] ppt

Typ: POINT*

Ein Zeiger auf eine POINT-Struktur , die die aktuelle Ziehposition empfängt. Kann NULL sein.

[out] pptHotspot

Typ: POINT*

Ein Zeiger auf eine POINT-Struktur , die den Offset des Ziehbilds relativ zur Ziehposition empfängt. Kann NULL sein.

[out] riid

Typ: REFIID

Eine IID für die Bildliste.

[out] ppv

Typ: PVOID*

Die Adresse eines Zeigers auf die Schnittstelle für die Bildliste, falls erfolgreich, andernfalls NULL .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die temporäre Imageliste wird zerstört, wenn IImageList::EndDrag aufgerufen wird. Um einen Ziehvorgang zu starten, verwenden Sie IImageList::BeginDrag.

Um IImageList::GetDragImage zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

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	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)