MouseEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornece dados para os eventos MouseUp, MouseDown e MouseMove.

public ref class MouseEventArgs : EventArgs

public class MouseEventArgs : EventArgs

type MouseEventArgs = class
    inherit EventArgs

Public Class MouseEventArgs
Inherits EventArgs

Herança

Object

EventArgs

MouseEventArgs

Derivado

System.Windows.Forms.DataGridViewCellMouseEventArgs

System.Windows.Forms.HandledMouseEventArgs

System.Windows.Forms.StatusBarPanelClickEventArgs

System.Windows.Forms.TreeNodeMouseClickEventArgs

Exemplos

O exemplo de código a seguir manipula o MouseDown evento em um TextBox controle para que clicar no botão direito do mouse selecione todo o texto no controle. Este exemplo requer que você tenha um formulário que contenha um TextBox controle chamado 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

O exemplo de código a seguir usa a Location propriedade para acompanhar cliques do botão esquerdo do mouse e para desenhar uma série de segmentos de linha reta em resposta à entrada do usuário. O exemplo não redesenhará as linhas se você ocultar o formulário e, em seguida, reproduzê-lo novamente; esse código foi 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;
    }
}

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

O exemplo de código a seguir usa as X propriedades e Y para exibir a posição atual do ponteiro do mouse em uma ToolTip janela.

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

Comentários

O MouseDown evento ocorre quando o usuário pressiona o botão do mouse enquanto o ponteiro está sobre um controle. O MouseUp evento ocorre quando o usuário libera o botão do mouse enquanto o ponteiro permanece sobre o controle. O MouseMove evento ocorre quando o usuário move o ponteiro do mouse sobre um controle . Um MouseEventArgs especifica qual botão do mouse é pressionado, quantas vezes o botão do mouse foi pressionado e liberado, as coordenadas do mouse e a quantidade que a roda do mouse moveu.

É possível receber um MouseDown evento sem um correspondente MouseUpse o usuário alternar o foco para outro aplicativo antes de liberar o botão do mouse.

Esses três eventos existem para as Controlclasses , AxHoste NotifyIcon .

Para obter informações sobre o modelo de evento, consulte Manipulando e gerando eventos.

Construtores

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

Inicializa uma nova instância da classe MouseEventArgs.

Propriedades

Button	Obtém o botão do mouse que foi pressionado.
Clicks	Obtém o número de vezes que o botão do mouse foi pressionado ou liberado.
Delta	Obtém uma contagem com sinal do número de detentores que a roda do mouse girou, multiplicado pela constante WHEEL_DELTA. Um detentor é um ponto da roda do mouse.
Location	Obtém o local do mouse durante o evento de geração do mouse.
X	Obtém a coordenada X do mouse durante o evento de mouse gerador.
Y	Obtém a coordenada y do mouse durante o evento de mouse gerador.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

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