Partilhar via

MouseEventArgs Classe

  • Referência

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
[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
Herança
Object
EventArgs
MouseEventArgs
Derivado
Atributos
ComVisibleAttribute

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)

Aplica-se a

Confira também