MouseEventArgs Osztály

Definíció

Adatokat biztosít a MouseUp, MouseDownés MouseMove eseményekhez.

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
Öröklődés
MouseEventArgs
Származtatott
Attribútumok

Példák

Az alábbi példakód egy vezérlő eseményét MouseDownTextBox kezeli, így a jobb egérgombbal kijelöli a vezérlő összes szövegét. Ebben a példában egy olyan űrlapot kell létrehoznia, amely egy TextBox elnevezett textBox1vezérlőelemet tartalmaz.

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

Az alábbi példakód a bal egérgomb kattintásainak nyomon követésére és egy sor egyenes vonalszakasz rajzolására használja a Location tulajdonságot a felhasználói bemenetre válaszul. A példa nem írja át újra a sorokat, ha elrejti az űrlapot, majd visszajátssza azt; ezt a kódot az egyszerűség kedvéért kihagyta.

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

Az alábbi példakód az egérmutató X aktuális pozícióját jeleníti meg az ablakban a tulajdonságok és Y a ToolTip tulajdonságok használatával.

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

Megjegyzések

Az MouseDown esemény akkor következik be, ha a felhasználó lenyomja az egérgombot, miközben az egérmutató egy vezérlő felett van. Az MouseUp esemény akkor következik be, amikor a felhasználó felengedi az egérgombot, miközben a mutató a vezérlő felett marad. Az MouseMove esemény akkor fordul elő, ha a felhasználó az egérmutatót egy vezérlő fölé helyezi. Az A MouseEventArgs határozza meg, hogy melyik egérgombot nyomja le, hányszor nyomták és engedték ki az egérgombot, az egér koordinátáit és az egérkerék mozgatásának mennyiségét.

Az esemény megfelelő nélkül MouseDownis fogadhatóMouseUp, ha a felhasználó az egérgomb felengedése előtt egy másik alkalmazásra vált a fókuszban.

Ez a három esemény létezik a , Controlés AxHost az NotifyIconosztályok számára.

Az eseménymodellről további információt az Események kezelése és emelése című témakörben talál.

Konstruktorok

Name Description
MouseEventArgs(MouseButtons, Int32, Int32, Int32, Int32)

Inicializálja a MouseEventArgs osztály új példányát.

Tulajdonságok

Name Description
Button

Lekérdezi, hogy melyik egérgombot nyomták le.

Clicks

Az egérgomb megnyomásának és kiadásának számát adja meg.

Delta

Lekéri az egérkerék elforgatott detentjeinek aláírt számát, megszorozva a WHEEL_DELTA állandóval. A detent az egérkerék egyik rovátkása.

Location

Lekéri az egér helyét a generáló egéresemény során.

X

Lekéri az egér x koordinátáját a generáló egéresemény során.

Y

Lekéri az egér y koordinátáját a generáló egéresemény során.

Metódusok

Name Description
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

A következőre érvényes:

Lásd még