Share via

MouseDown (Evento)

  • Artículo

Se produce cuando el usuario presiona un botón del mouse.

PROCEDURE Object.MouseDown
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 MouseDown 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 forma parte de una matriz de controles.

  • nButton
    Contiene un número que especifica qué botón se presiona para desencadenar el evento: 1 (izquierdo), 2 (derecho) o 4 (central).

  • nShift
    Contiene un número que especifica el estado de las teclas modificadoras cuando se hace clic con el mouse. 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, 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 mientras 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 especificado de coordenadas del Form y en la unidad de medida que establece el valor de la propiedad ScaleMode.

Observaciones

Utilice un procedimiento MouseDown para especificar acciones que se producen cuando se presiona un determinado botón del mouse. A diferencia de los eventos Click y DblClick, puede utilizar el evento MouseDown para distinguir entre los botones izquierdo, derecho y central del mouse. También puede escribir código para combinaciones de mouse y teclado que utilicen los modificadores de teclado.

Sugerencia   Puede utilizar un evento MouseMove para responder a un evento provocado al mover el mouse. El argumento nButton tiene un significado distinto según se trate de MouseDown y MouseUp, o de MouseMove. Para MouseDown o MouseUp, el argumento nButton indica exactamente un botón por evento; para MouseMove, indica el estado actual de todos los botones.

Vea también

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

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