MouseMove (Evento)

Se produce cuando el usuario mueve el mouse sobre un objeto.

PROCEDURE Object.MouseMove
LPARAMETERS [nIndex,] nButton, nShift, nXCoord, nYCoord

Parámetros

Es necesario incluir una instrucción LPARAMETERS o PARAMETERS en el procedimiento de evento y especificar un nombre para cada parámetro. Visual FoxPro transfiere al evento MouseMove cuatro o cinco parámetros en el orden siguiente:

• nIndex
  Contiene un número que identifica un control de forma única si éste está en una matriz de controles. El parámetro nIndex sólo se transfiere cuando el control está en una matriz de controles.

• nButton
  Contiene un número que especifica qué botón del mouse se estaba presionando mientras se movía el mouse, como se describe en la siguiente tabla:

  Valores de botón del mouse para nButton

  Ventanas	Valor nButton
  Botón izquierdo del mouse	1
  Botón derecho del mouse	2
  Botón medio del mouse	4

  Si se mantiene presionado más de un botón del mouse mientras se mueve el mouse, nButton contendrá la suma de los valores para los botones del mouse. Por ejemplo, si se presiona el botón derecho y el izquierdo del mouse, el valor de nButton será 3.

• nShift
  Contiene un número que especifica el estado de las teclas modificadoras cuando se mueve el mouse. En Visual FoxPro para Windows, 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.

  Valores de teclas modificadoras para nShift

  Tecla de Windows	Valor
  MAYÚS	1
  CTRL	2
  ALT	4

  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, en Visual FoxPro para Windows, si el usuario mantiene presionada la tecla CTRL mientras presiona el botón del mouse, el argumento nShift contiene 2. Pero si el usuario mantiene presionadas las teclas CTRL+ALT a la vez que presiona el botón del mouse, el argumento nShift contiene 6.

• nXCoord, nYCoord
  Contiene la posición horizontal (nXCoord) y vertical (nYCoord) actual del puntero del mouse en el formulario. Estas coordenadas siempre se expresan en términos del sistema de coordenadas del formulario y en la unidad de medida establecida por el valor de la propiedad ScaleMode.

El evento MouseMove se desencadena continuamente cuando el puntero del mouse se mueve por los objetos.

Nota   Puede utilizar los eventos MouseDown y MouseUp para responder a los eventos ocasionados al presionar y soltar los botones del mouse. El parámetro nButton para MouseMove es distinto del parámetro nButton para MouseDown y MouseUp. Para MouseMove, el parámetro nButton indica el estado actual de todos los botones; un solo evento MouseMove puede indicar que se está presionando algunos, todos o ningún botón. Para MouseDown o MouseUp, el parámetro nButton indica exactamente un solo botón por evento. Procure no mover una ventana dentro de un procedimiento del evento MouseMove, ya que puede hacer que los eventos lleguen en cascada y se generen errores en tiempo de ejecución, tal como un desbordamiento de pila. Los eventos MouseMove se desencadenan cuando la ventana se mueve debajo del puntero. Se puede desencadenar un evento MouseMove incluso si el mouse es estacionario.

Vea también

Click (Evento) | DblClick (Evento) | MiddleClick (Evento) | MousePointer (Propiedad) | MouseDown (Evento) | MouseUp (Evento) | MouseWheel (Evento)

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