MouseEventArgs Clase

Definición

public ref class MouseEventArgs : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public class MouseEventArgs : EventArgs

public class MouseEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type MouseEventArgs = class
    inherit EventArgs

type MouseEventArgs = class
    inherit EventArgs

Public Class MouseEventArgs
Inherits EventArgs

Herencia

Object

EventArgs

MouseEventArgs

Derivado

System.Windows.Forms.DataGridViewCellMouseEventArgs

System.Windows.Forms.HandledMouseEventArgs

System.Windows.Forms.StatusBarPanelClickEventArgs

System.Windows.Forms.TreeNodeMouseClickEventArgs

Atributos

ComVisibleAttribute

Ejemplos

En el ejemplo de código siguiente se controla el MouseDown evento en un TextBox control para que al hacer clic en el botón secundario del mouse se seleccione todo el texto del control. Este ejemplo requiere que tenga un formulario que contenga un TextBox control 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);
    }
}

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    TextBox1.ContextMenu = New ContextMenu()
End Sub

Private Sub TextBox1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles TextBox1.MouseDown
    If (e.Button = Windows.Forms.MouseButtons.Right) Then
        TextBox1.Select(0, TextBox1.Text.Length)
    End If
End Sub

En el ejemplo de código siguiente se usa la Location propiedad para realizar un seguimiento de los clics del botón izquierdo del mouse y dibujar una serie de segmentos de línea recta en respuesta a la entrada del usuario. En el ejemplo no se vuelven a dibujar las líneas si se oculta el formulario y, a continuación, se vuelve a reproducir; este código se ha omitido por motivos de simplicidad.

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;
    }
}

Dim FirstPoint As Point
Dim HaveFirstPoint As Boolean = False

Private Sub Form1_MouseDownDrawing(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles Me.MouseDown
    If HaveFirstPoint Then
        Dim g As Graphics = Me.CreateGraphics()
        g.DrawLine(Pens.Black, FirstPoint, e.Location)
        HaveFirstPoint = False
    Else
        FirstPoint = e.Location
        HaveFirstPoint = True
    End If
End Sub

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

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);
}

Dim TrackTip As ToolTip

Private Sub TrackCoordinates()
    TrackTip = New ToolTip()
End Sub

Private Sub Form1_MouseMove(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles Me.MouseMove
    Dim TipText As String = String.Format("({0}, {1})", e.X, e.Y)
    TrackTip.Show(TipText, Me, e.Location)
End Sub

Comentarios

El MouseDown evento se produce cuando el usuario presiona el botón del mouse mientras el puntero está sobre un control. El MouseUp evento se produce cuando el usuario suelta el botón del mouse mientras el puntero permanece sobre el control. El MouseMove evento se produce cuando el usuario mueve el puntero del mouse sobre un control. Un MouseEventArgs especifica qué botón del mouse se presiona, cuántas veces se ha presionado y liberado el botón del mouse, las coordenadas del mouse y la cantidad en que se movió la rueda del mouse.

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

Estos tres eventos existen para las Controlclases , AxHosty NotifyIcon .

Para obtener información sobre el modelo de eventos, consulte Control y generación de eventos.

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

• OnMouseDown(MouseEventArgs)
• MouseDown
• OnMouseUp(MouseEventArgs)
• MouseUp
• OnMouseMove(MouseEventArgs)
• MouseMove
• MouseDown
• MouseUp
• MouseMove