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 auf einem TextBox Steuerelement behandelt, sodass das Klicken auf die rechte Maustaste den gesamten Text im Steuerelement auswählt. In diesem Beispiel ist erforderlich, dass Sie über ein Formular verfügen, das ein TextBox Steuerelement enthält, das benannt textBox1ist.

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 Liniensegmente als Reaktion auf die Benutzereingabe zu zeichnen. Im Beispiel werden die Linien nicht neu gezeichnet, wenn Sie das Formular ausblenden und dann erneut anzeigen; dieser Code wurde für die Einfachheit nicht angegeben.

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 und Y die X Eigenschaften 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 der Zeiger über ein Steuerelement liegt. Das MouseUp Ereignis tritt auf, wenn der Benutzer die Maustaste freigibt, während der Zeiger über das Steuerelement bleibt. Das MouseMove Ereignis tritt auf, wenn der Benutzer den Mauszeiger über ein Steuerelement verschiebt. Ein MouseEventArgs gibt an, welche Maustaste gedrückt wird, wie viele Mal die Maustaste gedrückt und freigegeben wurde, die Koordinaten der Maus und die Menge, die das Mausrad verschoben hat.

Es ist möglich, ein MouseDown Ereignis ohne entsprechendes MouseUpEreignis zu erhalten, wenn der Benutzer den Fokus auf eine andere Anwendung wechselt, bevor die Maustaste freigegeben wird.

Diese drei Ereignisse sind für die Control, AxHostund NotifyIcon Klassen 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:

Siehe auch