MouseEventArgs Classe

Definição

public ref class MouseEventArgs : EventArgs

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

[<System.Runtime.InteropServices.ComVisible(true)>]
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

Atributos

ComVisibleAttribute

Exemplos

O exemplo de código seguinte lida com o MouseDown evento num TextBox controlo de modo que, ao clicar no botão direito do rato, se seleciona todo o texto no controlo. Este exemplo exige que tenhas uma forma que contenha um TextBox controlo 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.ContextMenuStrip = New ContextMenuStrip()
End Sub

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

O exemplo de código seguinte utiliza a Location propriedade para rastrear cliques do botão esquerdo do rato e para desenhar uma série de segmentos em linha reta em resposta à entrada do utilizador. O exemplo não redesenha as linhas se esconderes o formulário e depois o voltares a exibir; Este código foi omitido por simplicidade.

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 seguinte utiliza as X propriedades e Y para mostrar a posição atual do ponteiro do rato numa 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

Observações

O MouseDown evento ocorre quando o utilizador pressiona o botão do rato enquanto o ponteiro está sobre um controlo. O MouseUp evento ocorre quando o utilizador solta o botão do rato enquanto o ponteiro permanece sobre o controlo. O MouseMove evento ocorre quando o utilizador move o ponteiro do rato sobre um controlo. A especifica qual botão do rato é pressionado, quantas vezes o botão foi pressionado e largado, as coordenadas do rato e a quantidade de MouseEventArgs movimento da roda do rato.

É possível receber um MouseDown evento sem um correspondente MouseUp, se o utilizador mudar o foco para outra aplicação antes de largar o botão do rato.

Estes três eventos existem para as Controlclasses , AxHost, e NotifyIcon .

Para informações sobre o modelo de eventos, consulte Gestão e Angariação de Eventos.

Ver também

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