Compartir a través de

MouseEventArgs Clase

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Proporciona datos para los eventos MouseUp, MouseDown y MouseMove.

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

MouseEventArgs(MouseButtons, Int32, Int32, Int32, Int32)

Inicializa una nueva instancia de la clase MouseEventArgs.

Propiedades

Button

Obtiene qué botón del mouse se presionó.
Clicks

Obtiene el número de veces que el botón del mouse se presionó y se soltó.
Delta

Obtiene un recuento con signo del número de pasos que ha girado la rueda del mouse, multiplicado por la constante WHEEL_DELTA. Un paso es una muesca de la rueda del mouse.
Location

Obtiene la ubicación del mouse durante el evento de mouse que se genera.
X

Obtiene la coordenada X del mouse durante el evento de mouse que se genera.
Y

Obtiene la coordenada Y del mouse durante el evento de mouse que se genera.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también