MouseEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- Abgeleitet
- Attribute
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 textBox1
ist.
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) |