OLEDragOver (Evento)

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

PROCEDURE Object.OLEDragOver
LPARAMETERS oDataObject, nEffect, nButton,
 nShift,   nXCoord, nYCoord, nState

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 OLEGiveFeedback, que indica la acción realizada si los datos se colocan 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. La tabla siguiente muestra los valores de nEffect con una descripción de cada acción.

  nEffect	Constante de Foxpro.h	Descripción
  0	DROPEFFECT_NONE	El destino para colocar no acepta los datos o se ha cancelado la operación colocar.
  1	DROPEFFECT_COPY	Los datos se copian del origen de arrastre al destino para colocar.
  2	DROPEFFECT_MOVE	Se han movido datos del origen de arrastre al destino para colocar.
  4	DROPEFFECT_LINK	Se han vinculado datos del origen de arrastre al destino para colocar.

• nButton
  Contiene un número que especifica qué botón del mouse está presionado cuando se arrastran datos sobre un destino para colocar: 1 (primario), 2 (secundario) o 4 (central).

• nShift
  Contiene un número que especifica el estado de las teclas modificadoras cuando se arrastran datos sobre un 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 el usuario 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 arrastran datos sobre un 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.

• nState
  Contiene un número que especifica la dirección en que se arrastran los datos (al control u objeto, dentro del control u objeto o fuera del control u objeto). Los valores de nState se muestran en la tabla siguiente.

  nState	Descripción
  0	Se arrastran datos al control u objeto. Las propiedades OLEDropEffects y OLEDropHasData se pueden establecer cuando nState vale cero.
  1	Se arrastran datos fuera del control u objeto.
  2	Se arrastran datos dentro del control u objeto.

Observaciones

OLEDragOver es un evento de destino para colocar que sólo ocurre cuando la propiedad OLEDropMode para el 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.

Observe que debe evitar crear estados de espera en el evento OLEDragOver con comandos y funciones como WINDOW y MESSAGEBOX( ).

Vea también

Introducción a arrastrar y colocar OLE | OLEGiveFeedback (Evento) | OLEDropEffects (Propiedad) | OLEDropHasData (Propiedad) | 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