OLEDragDrop (Evento)

Ocurre cuando se colocan datos en un destino de colocación y la propiedad OLEDropMode de éste tiene el valor 1 – Activado.

PROCEDURE Object.OLEDragDrop
LPARAMETERS oDataObject, nEffect, nButton,
 nShift,   nXCoord, nYCoord

Valores de la propiedad

• oDataObject
  Una referencia de objeto a un DataObject de arrastrar y colocar de OLE, utilizado con los métodos GetData y GetFormat para devolver datos y formatos de datos en el DataObject.

• nEffect
  Un valor pasado al evento OLECompleteDrag, que indica la acción realizada cuando se colocan datos en el destino para colocar. nEffect es inicialmente un valor que indica las operaciones arrastrar y colocar de OLE admitidas por el origen de arrastre. En el evento OLEDragDrop puede cambiar el valor de nEffect que se pasa al evento OLECompleteDrag. Si cambia el valor de nEffect, asegúrese de incluir NODEFAULT en el código de evento para evitar el comportamiento predeterminado. La tabla siguiente muestra los valores de nEffect que puede pasar al evento OLECompleteDrag con una descripción de cada acción.

  nEffect	Constante de Foxpro.h	Descripción
  0	DROPEFFECT_NONE	El destino para colocar no aceptó los datos o se canceló la operación colocar.
  1	DROPEFFECT_COPY	Los datos se copiaron del origen de arrastre al destino para colocar.
  2	DROPEFFECT_MOVE	Los datos se movieron del origen de arrastre al destino para colocar.
  4	DROPEFFECT_LINK	Los datos se vincularon del origen de arrastre al destino para colocar.

• nButton
  Contiene un número que especifica que botón del mouse se ha liberado para colocar los datos en el destino: 1 (primario), 2 (secundario) o 4 (central).

• nShift
  Contiene un número que especifica el estado de las teclas modificadoras cuando se libera el botón del mouse para colocar los datos en el destino para colocar. Las teclas modificadoras válidas son MAYÚS, CTRL y ALT. Los valores que se devuelven en nShift para las teclas modificadoras individuales se muestran en la siguiente tabla.

  nShift	Tecla modificadora
  1	MAYÚS
  2	CTRL
  4	ALT

  Si se mantienen presionadas una o más teclas modificadoras mientras se hace clic con el mouse, el argumento nShift contiene la suma de los valores para las teclas modificadoras. Por ejemplo, si el usuario presiona CTRL mientras libera el botón del mouse, el argumento nShift contiene 2. Pero si presiona CTRL+ALT mientras libera el botón del mouse, el argumento nShift contiene 6.

• nXCoord, nYCoord
  Contiene la posición horizontal (nXCoord) y vertical (nYCoord) del puntero del mouse en el formulario cuando se libera el botón del mouse para colocar datos en el destino para colocar. Estas coordenadas se expresan en términos del sistema de coordenadas del formulario en la unidad de medida especificada por la propiedad ScaleMode del formulario.

Observaciones

OLEDragDrop es un evento del destino para colocar que sólo se produce cuando la propiedad OLEDropMode del control u objeto está establecida a 1 – Habilitado. Este evento no ocurre si la propiedad OLEDropMode está establecida a 0 – Deshabilitado o a 2 – Pasar al contenedor.

Si realiza su propio proceso de colocar en el evento OleDragDrop, incluya NODEFAULT para evitar que se produzca la operación colocar predeterminada. En este caso, debe establece el valor resultante de nEffect.

Vea también

Introducción a arrastrar y colocar OLE | OLECompleteDrag (Evento) | OLEDropMode (Propiedad)

Se aplica a: CheckBox | ComboBox | CommandButton | CommandGroup | Container (Objeto) | Control (Objeto) | EditBox | Form | Grid | Image | Label | Line | ListBox | OptionButton | OptionGroup | Page | PageFrame | ProjectHook (Objeto) | Shape | Spinner | TextBox | ToolBar