Freigeben über

MouseEventArgs Klasse

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Stellt Daten für das MouseUp-Ereignis, das MouseDown-Ereignis und das MouseMove-Ereignis bereit.

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
Vererbung
Object
EventArgs
MouseEventArgs
Abgeleitet
Attribute
ComVisibleAttribute

Beispiele

Im folgenden Codebeispiel wird das MouseDown Ereignis für ein TextBox Steuerelement behandelt, sodass durch Klicken mit der rechten Maustaste der gesamte Text im Steuerelement ausgewählt wird. Dieses Beispiel erfordert, dass Sie über ein Formular verfügen, das ein TextBox Steuerelement mit dem Namen textBox1enthält.

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

Im folgenden Codebeispiel wird die Location -Eigenschaft verwendet, um Klicks der linken Maustaste nachzuverfolgen und eine Reihe gerader Segmente als Reaktion auf Benutzereingaben zu zeichnen. Im Beispiel werden die Zeilen nicht neu gezeichnet, wenn Sie das Formular ausblenden und es dann erneut anzeigen. Dieser Code wurde der Einfachheit halber weggelassen.

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

Im folgenden Codebeispiel werden die X Eigenschaften und Y verwendet, um die aktuelle Position des Mauszeigers in einem ToolTip Fenster anzuzeigen.

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

Hinweise

Das MouseDown Ereignis tritt auf, wenn der Benutzer die Maustaste drückt, während sich der Zeiger über ein Steuerelement befindet. Das MouseUp Ereignis tritt auf, wenn der Benutzer die Maustaste loslässt, während der Zeiger über dem Steuerelement verbleibt. Das MouseMove Ereignis tritt auf, wenn der Benutzer den Mauszeiger über ein Steuerelement bewegt. Ein MouseEventArgs gibt an, welche Maustaste gedrückt wird, wie oft die Maustaste gedrückt und losgelassen wurde, die Koordinaten der Maus und die Menge, die das Mausrad bewegt hat.

Es ist möglich, ein MouseDown Ereignis ohne entsprechendes MouseUpzu empfangen, wenn der Benutzer den Fokus auf eine andere Anwendung wechselt, bevor er die Maustaste loslässt.

Diese drei Ereignisse sind für die ControlKlassen , AxHostund NotifyIcon vorhanden.

Informationen zum Ereignismodell finden Sie unter Behandeln und Auslösen von Ereignissen.

Konstruktoren

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

Initialisiert eine neue Instanz der MouseEventArgs-Klasse.

Eigenschaften

Button

Ruft ab, welche Maustaste gedrückt wurde.
Clicks

Ruft ab, wie oft die Maustaste gedrückt und losgelassen wurde.
Delta

Ruft einen Zähler mit Vorzeichen für die Anzahl der Arretierungen ab, um die das Mausrad gedreht wurde, der mit der Konstanten WHEEL_DELTA multipliziert wird. Eine Arretierung (Rastpunkt) ist eine Kerbe des Mausrades.
Location

Ruft die Position der Maus während des generierten Mausereignisses ab.
X

Ruft die x-Koordinate der Maus während des generierten Mausereignisses ab.
Y

Ruft die y-Koordinate der Maus während des generierten Mausereignisses ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen