MouseEventArgs Klasse

Definition

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

Stellt Daten für die MouseUpEreignisse MouseDownund Ereignisse bereit MouseMove .

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

Beispiele

Im folgenden Codebeispiel wird das MouseDown Ereignis in einem TextBox Steuerelement behandelt, sodass durch Klicken auf die rechte Maustaste der gesamte Text im Steuerelement markiert wird. Dieses Beispiel erfordert, dass Sie über ein Formular verfügen, das ein TextBox Steuerelement enthält, das den Namen textBox1hat.

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

Im folgenden Codebeispiel wird die Location Eigenschaft verwendet, um Klicks auf die linke Maustaste nachzuverfolgen und eine Reihe gerader Liniensegmente als Reaktion auf Benutzereingaben zu zeichnen. Im Beispiel werden die Linien nicht neu gezeichnet, wenn Sie das Formular ausblenden und dann erneut anzeigen. Dieser Code wurde aus Gründen der 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 sich der Mauszeiger über einem Steuerelement befindet. Das MouseUp Ereignis tritt auf, wenn der Benutzer die Maustaste loslässt, während der Mauszeiger ü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 wurde.

Es ist möglich, ein MouseDown Ereignis ohne entsprechendes MouseUpEreignis zu 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 AxHost, und NotifyIcon die Klassen vorhanden.

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

Konstruktoren

Name Beschreibung
MouseEventArgs(MouseButtons, Int32, Int32, Int32, Int32)

Initialisiert eine neue Instanz der MouseEventArgs-Klasse.

Eigenschaften

Name Beschreibung
Button

Ruft ab, welche Maustaste gedrückt wurde.
Clicks

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

Ruft eine signierte Anzahl der Detents ab, die das Mausrad gedreht hat, multipliziert mit der WHEEL_DELTA Konstanten. Ein Detent ist eine Notte des Mausrads.
Location

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

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

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

Methoden

Name Beschreibung
Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Gilt für:

Weitere Informationen