Share via

DragOver (Evento)

  • Artículo

Se produce cuando se arrastra un control sobre un objeto de destino.

PROCEDURE Object.DragOver
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord, nState

Parámetros

Incluya una instrucción LPARAMETERS o PARAMETERS en el procedimiento de evento y especifique un nombre para cada parámetro. De lo contrario, se producirá un error. Visual FoxPro transfiere al evento DragOver cuatro o cinco parámetros en el orden siguiente:

  • nIndex
    Identifica de forma única un control si está en una matriz de controles.

  • oSource
    Contiene una referencia al control que se arrastra. Es posible hacer referencia a propiedades y métodos del control con este parámetro.

  • 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 representa el estado de transición del control que se arrastra en relación con el objeto de destino:

    Valor Descripción
    0 Entrar. El control se arrastra dentro del alcance de un destino.
    1 Salir. El control se arrastra fuera del alcance de un destino.
    2 Sobre. El control se ha movido desde una posición del destino a otra.

  • Utilice nState para determinar acciones en puntos de transición clave. Por ejemplo, puede resaltar un posible destino en nState = 0 (Entrar) y restaurar la apariencia del objeto en nState = 1 (Salir).

Cuando un objeto recibe un evento DragOver con nState = 0 (Entrar):

  • Se desencadena un evento DragDrop si el control de código fuente se coloca en un objeto de destino.
  • Se desencadena otro evento DragOver con nState = 1 (Salir) si el control de código fuente no se coloca en un destino válido.

Observaciones

El objeto bajo el icono de arrastre es el objeto de destino y el que responde al evento DragOver. Puede utilizar este evento para supervisar cuando el puntero del mouse entra, sale o está directamente sobre un objeto de destino.

Utilice un evento DragOver para determinar qué sucede después de iniciarse el arrastre y antes de que se coloque un control sobre un destino. Por ejemplo, puede comprobar un intervalo de destino válido resaltando el destino. Para ello, establezca la propiedad BackColor o ForeColor o muestre un puntero especial.

Vea también

Drag (Método) | DragDrop (Evento) | DragIcon (Propiedad) | DragMode (Propiedad) | MouseDown (Evento) | MouseUp (Evento) | MouseMove (Evento)

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