MouseEventArgs (Clase)

El evento MouseDown tiene lugar cuando el usuario presiona el botón del mouse (ratón) mientras el puntero se encuentra sobre un control. El evento MouseUp tiene lugar cuando el usuario suelta el botón del mouse mientras el puntero permanece sobre el control. El evento MouseMovetiene lugar cuando el usuario mueve el puntero del mouse sobre un control. MouseEventArgs especifica qué botón del mouse se presiona, cuántas veces se presiona y se suelta, las coordenadas del mouse y cuánto se mueve la rueda del mouse.

Es posible recibir un evento MouseDown sin el correspondiente MouseUp, si el usuario cambia el foco a otra aplicación antes de liberar el botón del mouse (ratón).

Estos tres eventos existen para las clases Control, AxHost y NotifyIcon.

Para obtener información acerca del modelo de eventos, vea Eventos y delegados.

En el siguiente ejemplo de código se controla el evento MouseDown en un control TextBox de manera que al hacer clic con el botón secundario del mouse se selecciona todo el texto del control. En este ejemplo se requiere que se disponga de un formulario con un control TextBox denominado textBox1.

private void Form1_Load(object sender, EventArgs e)
{
    // This line suppresses the default context menu for the TextBox control. 
    textBox1.ContextMenu = new ContextMenu();
    textBox1.MouseDown += new MouseEventHandler(textBox1_MouseDown);
}

void textBox1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
    if (e.Button == MouseButtons.Right)
    {
        textBox1.Select(0, textBox1.Text.Length);
    }
}

En el siguiente ejemplo de código se utiliza la propiedad Location para realizar el seguimiento de los clics realizados con el botón primario del mouse y dibujar una serie de segmentos en línea recta como respuesta a la entrada del usuario. El ejemplo no vuelve a dibujar las líneas si oculta el formulario y, a continuación, lo vuelve a mostrar; este código se ha omitido para simplificar.

Point firstPoint;
Boolean haveFirstPoint;

public void EnableDrawing()
{
    this.MouseDown += new MouseEventHandler(Form1_MouseDownDrawing);
}

void Form1_MouseDownDrawing(object sender, System.Windows.Forms.MouseEventArgs e)
{
    if (haveFirstPoint)
    {
        Graphics g = this.CreateGraphics();
        g.DrawLine(Pens.Black, firstPoint, e.Location);
        haveFirstPoint = false;
    }
    else
    {
        firstPoint = e.Location;
        haveFirstPoint = true;
    }
}

En el ejemplo de código siguiente se utilizan las propiedades X y Y para mostrar la posición actual del puntero del mouse en una ventana ToolTip.

ToolTip trackTip;

private void TrackCoordinates()
{
    trackTip = new ToolTip();
    this.MouseMove += new MouseEventHandler(Form1_MouseMove);
}

void Form1_MouseMove(object sender, System.Windows.Forms.MouseEventArgs e)
{
    String tipText = String.Format("({0}, {1})", e.X, e.Y);
    trackTip.Show(tipText, this, e.Location);
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Pocket PC

.NET Framework

.NET Compact Framework

Referencia