Freigeben über

IImageList::BeginDrag-Methode (commoncontrols.h)

  • Artikel

Beginnt mit dem Ziehen eines Bilds.

Syntax

HRESULT BeginDrag(
  [in] int iTrack,
  [in] int dxHotspot,
  [in] int dyHotspot
);

Parameter

[in] iTrack

Typ: int

Ein Wert vom Typ int , der den Index des zu ziehenden Bilds enthält.

[in] dxHotspot

Typ: int

Ein Wert vom Typ int , der die x-Komponente der Ziehposition relativ zur linken oberen Ecke des Bilds enthält.

[in] dyHotspot

Typ: int

Ein Wert vom Typ int , der die y-Komponente der Ziehposition relativ zur linken oberen Ecke des Bilds enthält.

Rückgabewert

Typ: HRESULT

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

Hinweise

IImageList::BeginDrag erstellt eine temporäre Bildliste, die zum Ziehen verwendet wird. Als Reaktion auf nachfolgende WM_MOUSEMOVE Nachrichten können Sie das Bild mithilfe von IImageList::D ragMove verschieben. Um den Ziehvorgang zu beenden, können Sie IImageList::EndDrag verwenden.

Um IImageList::BeginDrag 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)