MouseEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fornisce dati per gli eventi 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
Ereditarietà
Object
EventArgs
MouseEventArgs
Derivato
Attributi
ComVisibleAttribute

Esempio

Nell'esempio di codice seguente viene gestito l'evento MouseDown in un TextBox controllo in modo che facendo clic sul pulsante destro del mouse venga selezionato tutto il testo nel controllo. In questo esempio è necessario disporre di un modulo contenente un TextBox controllo denominato 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

Nell'esempio di codice seguente viene usata la Location proprietà per tenere traccia dei clic del pulsante sinistro del mouse e per disegnare una serie di segmenti di linea retta in risposta all'input dell'utente. L'esempio non ridisegna le righe se si nasconde il modulo e quindi la ridisplay; questo codice è stato omesso per semplicità.

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

Nell'esempio di codice seguente vengono usate le X proprietà e Y per visualizzare la posizione corrente del puntatore del mouse in una ToolTip finestra.

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

Commenti

L'evento MouseDown si verifica quando l'utente preme il pulsante del mouse mentre il puntatore è su un controllo. L'evento MouseUp si verifica quando l'utente rilascia il pulsante del mouse mentre il puntatore rimane sul controllo. L'evento MouseMove si verifica quando l'utente sposta il puntatore del mouse su un controllo. Specifica MouseEventArgs il pulsante del mouse premuto, il numero di volte in cui il pulsante del mouse è stato premuto e rilasciato, le coordinate del mouse e la quantità della rotellina del mouse spostata.

È possibile ricevere un MouseDown evento senza un corrispondente MouseUp, se l'utente passa lo stato attivo a un'altra applicazione prima di rilasciare il pulsante del mouse.

Questi tre eventi esistono per le Controlclassi , AxHoste NotifyIcon .

Per informazioni sul modello di evento, vedere Gestione e generazione di eventi.

Costruttori

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

Inizializza una nuova istanza della classe MouseEventArgs.

Proprietà

Button

Ottiene il pulsante del mouse che è stato premuto.
Clicks

Ottiene il numero di volte che il pulsante del mouse è stato premuto e rilasciato.
Delta

Ottiene un conteggio con segno del numero di dentelli in base al quale è stata spostata la rotellina del mouse moltiplicato per la costante WHEEL_DELTA. Un dentello corrisponde a uno scatto della rotellina del mouse.
Location

Ottiene la posizione del mouse durante la generazione del relativo evento.
X

Ottiene la coordinata x del mouse durante la generazione del relativo evento.
Y

Ottiene la coordinata y del mouse durante la generazione del relativo evento.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche