DOC: DoDragDrop() Parameter Documented Incorrectly

ID: Q131100


The information in this article applies to:
  • The Microsoft Foundation Classes (MFC), included with:
    • Microsoft Visual C++ for Windows, 16-bit edition, versions 1.5, 1.51, 1.52
    • Microsoft Visual C++, 32-bit Editions, versions 2.0, 2.1, 5.0


SUMMARY

The documentation for COleClientItem::DoDragDrop(), COleServerItem::DoDragDrop(), and COleDataSource::DoDragDrop() give the following incorrect information for the lpRectStartDrag parameter:

In Visual C++ Prior to 5.0

lpRectStartDrag: 

   Pointer to the rectangle that defines where the drag
   actually starts. It does not start until the mouse cursor leaves the
   rectangle. If NULL, a default rectangle is used so that the drag
   starts when the mouse cursor moves one pixel. 

In Visual C++ 5.0

Call the DoDragDrop member function to perform a drag-and-drop operation. The drag-and-drop operation does not start immediately. It waits until the mouse cursor leaves the rectangle specified by lpRectStartDrag or until a specified number of milliseconds have passed. If lpRectStartDrag is NULL, the size of the rectangle is one pixel. The delay time is specified by the DragDelay value in the [Windows] section of WIN.INI. If this value is not in WIN.INI, the default value of 200 milliseconds is used.

Correction

The documentation for the lpRectStartDrag parameter for DoDragDrop() should be:

lpRectStartDrag: 

   Pointer to the rectangle that defines where the drag
   actually starts. It does not start until the mouse cursor leaves the
   rectangle or until a specific number of milliseconds has passed. If
   NULL, a default rectangle is used so that the drag starts when the
   mouse cursor moves one pixel. The number of milliseconds is specified
   by a registry key setting. The value can be found in the Windows NT
   system registry under the key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ 
   Windows\NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay,
   or in the WIN.INI file under the [Windows] section if running under
   Windows version 3.x. If the key is not present, a default value of 200
   milliseconds is used. 


STATUS

This problem was corrected in Visual C++ version 6.0 for Windows.

Additional query words:

Keywords : kbole kbdocerr kbMFC kbVC500bug kbVC600fix
Version : 1.5 1.51 1.52 2.0 2.1 5.0
Platform : NT WINDOWS
Issue type :


Last Reviewed: July 22, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.