COleClientItem::DoDragDrop

Artikel
02/26/2013

Rufen Sie die DoDragDrop-Memberfunktion auf, um ein Drag & Drop-Vorgang auszuführen.

DROPEFFECT DoDragDrop(
   LPCRECT lpItemRect,
   CPoint ptOffset,
   BOOL bIncludeLink = FALSE,
   DWORD dwEffects = DROPEFFECT_COPY | DROPEFFECT_MOVE,
   LPCRECT lpRectStartDrag = NULL 
);

Parameter

lpItemRect
Das Rechteck des Elements auf dem Bildschirm in Clientkoordinaten (Pixel).
ptOffset
Der Offset von lpItemRect, in dem die Mausposition zum Zeitpunkt des Ziehens war.
bIncludeLink
Legen Sie diese Eigenschaft auf TRUE fest, wenn die Linkdaten in die Zwischenablage kopiert werden.Legen Sie sie zu FALSE fest, wenn die Serveranwendung nicht Links ausführt.
dwEffects
Bestimmt die Auswirkungen, die die Quelle des Ziehvorgangs im Ziehvorgang zulässig.
lpRectStartDrag
Zeiger auf das Rechteck, das definiert, wo das Ziehen tatsächlich beginnt.Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Ein DROPEFFECT-Wert.Wenn es DROPEFFECT_MOVE ist, sollten die ursprünglichen Daten entfernt werden.

Hinweise

Das Drag & Drop-Operation beginnt nicht sofort.Es wartet, bis der Mauszeiger das Rechteck gekennzeichnet durch lpRectStartDrag verlässt, oder bis eine angegebene Anzahl an Millisekunden übergeben haben.Wenn lpRectStartDragNULL ist, ist die Größe des Rechtecks ein Pixel.

Die Verzögerung wird durch eine Registrierungsschlüsseleinstellung angegeben.Sie können die Verzögerung ändern, indem Sie CWinApp::WriteProfileString oder CWinApp::WriteProfileInt aufrufen.Wenn Sie nicht die Verzögerung angeben, wird ein Standardwert von 200 Millisekunden verwendet.Ziehverzögerung gespeichert, wie folgt:

Windows NT-Ziehverzögerung wird in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay gespeichert.
Ziehverzögerung Windows 3.x wird in der WIN.INI-Datei, unter dem Abschnitt [Windows-} gespeichert.
Windows 95/98-Ziehverzögerung wird in einer zwischengespeicherten Version von WIN.INI gespeichert.

Weitere Informationen dazu, wie Ziehverzögerungsinformationen entweder in der Registrierung oder in der INI-Datei gespeichert werden, finden Sie unter WriteProfileString in Windows SDK.