COleDataSource::DoDragDrop

Artículo
02/19/2013

Llame a la función miembro de DoDragDrop para realizar una operación de arrastrar y colocar para este origen de datos, normalmente en un controlador de CWnd:: OnLButtonDown .

DROPEFFECT DoDragDrop(
   DWORD dwEffects = DROPEFFECT_COPY|DROPEFFECT_MOVE|DROPEFFECT_LINK,
   LPCRECT lpRectStartDrag = NULL,
   COleDropSource* pDropSource = NULL 
);

Parámetros

dwEffects
Operaciones de arrastrar y colocar que se permiten en este origen de datos.Pueden ser uno o más de los siguientes:
- La operación de copia deDROPEFFECT_COPY A podría realizar.
- La operación de movimiento deDROPEFFECT_MOVE A podría realizar.
- El vínculo deDROPEFFECT_LINK A de los datos colocados a los datos originales podría establecer.
- DROPEFFECT_SCROLL Indica que una operación de desplazamiento de arrastre podría aparecer.
lpRectStartDrag
Puntero al rectángulo que define dónde arrastre inicia realmente.Para obtener más información, vea la siguiente sección de notas.
pDropSource
Señala a un origen de colocación.Si NULL a una implementación predeterminada de COleDropSource se utiliza.

Valor devuelto

Efecto de entrega generado por la operación de arrastrar y colocar; si no DROPEFFECT_NONE si nunca inicia la operación porque el usuario lanzó el botón del mouse antes de que el rectángulo proporcionado.

Comentarios

La operación de arrastrar y colocar no se inicia inmediatamente.Espera hasta el cursor deja el rectángulo especificado por lpRectStartDrag o hasta un número especificado de milisegundos han pasado.Si lpRectStartDrag es NULL, el tamaño del rectángulo es un píxel.

El tiempo de retraso especificado por un valor de la clave del Registro.Puede cambiar el tiempo de retraso llamando a CWinApp:: WriteProfileString o CWinApp:: WriteProfileInt.Si no especifica el tiempo de retraso, un valor predeterminado de 200 milisegundos se utiliza.Se almacena el tiempo de retraso de arrastre como sigue:

El tiempo de retraso de arrastre de Windows NT se almacena en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft Windows NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay.
El tiempo de retraso de arrastre de Windows 3.x se almacena en el archivo Win.ini, bajo [a la sección de Windows}.
Windows 95 /98 tiempo de retraso de arrastre se almacena en una versión almacenada en memoria caché de WIN.INI.

Para obtener más información sobre cómo la información del retraso de arrastre se almacena en el registro o en el archivo de .INI, vea WriteProfileString en Windows SDK.

Para obtener más información, vea el artículo Arrastrar y colocar: implementar un origen de colocación.