MouseEventArgs 클래스


MouseUp, MouseDownMouseMove 이벤트에 대한 데이터를 제공합니다.Provides data for the MouseUp, MouseDown, and MouseMove events.

public ref class MouseEventArgs : EventArgs
public class MouseEventArgs : EventArgs
type MouseEventArgs = class
    inherit EventArgs
Public Class MouseEventArgs
Inherits EventArgs


다음 코드 예제에서는 마우스 오른쪽 단추를 클릭 하 여 컨트롤의 모든 텍스트를 선택 하도록 TextBox 컨트롤의 MouseDown 이벤트를 처리 합니다.The following code examples handles the MouseDown event on a TextBox control so that clicking the right mouse button selects all the text in the control. 이 예에서는 textBox1이라는 TextBox 컨트롤을 포함 하는 양식이 필요 합니다.This example requires that you have a form that contains a TextBox control that is named textBox1.

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

다음 코드 예제에서는 Location 속성을 사용 하 여 마우스 왼쪽 단추의 클릭을 추적 하 고 사용자 입력에 대 한 응답으로 일련의 직선 세그먼트를 그립니다.The following code example uses the Location property to track clicks of the left mouse button and to draw a series of straight line segments in response to user input. 폼을 숨기고,를 다시 표시 하는 경우이 예제에서는 줄 그려지지 않습니다. 이 코드는 편의상 생략 되었습니다.The example does not redraw the lines if you hide the form and then redisplay it; this code has been omitted for simplicity.

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;
        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
        FirstPoint = e.Location
        HaveFirstPoint = True
    End If
End Sub

다음 코드 예제에서는 XY 속성을 사용 하 여 ToolTip 창에 마우스 포인터의 현재 위치를 표시 합니다.The following code example uses the X and Y properties to display the current position of the mouse pointer in a ToolTip window.

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


MouseDown 이벤트는 포인터가 컨트롤 위에 있는 동안 사용자가 마우스 단추를 누를 때 발생 합니다.The MouseDown event occurs when the user presses the mouse button while the pointer is over a control. MouseUp 이벤트는 포인터가 컨트롤 위에 있는 동안 사용자가 마우스 단추를 놓으면 발생 합니다.The MouseUp event occurs when the user releases the mouse button while the pointer remains over the control. 사용자가 마우스 포인터를 컨트롤 위로 이동 하면 MouseMove 이벤트가 발생 합니다.The MouseMove event occurs when the user moves the mouse pointer over a control. 마우스 단추를 누르는 방법, 마우스 단추를 눌렀다 놓은 횟수, 마우스 좌표 및 마우스 휠을 이동한 정도를 지정 하는 MouseEventArgs입니다.A MouseEventArgs specifies which mouse button is pressed, how many times the mouse button was pressed and released, the coordinates of the mouse, and the amount the mouse wheel moved.

받을 수 있습니다는 MouseDown 해당 없이 이벤트 MouseUp이면 사용자가 마우스 단추에서 손을 떼기 전에 다른 애플리케이션에 포커스를 전환 합니다.It is possible to receive a MouseDown event without a corresponding MouseUp, if the user switches focus to another application before releasing the mouse button.

이러한 세 이벤트는 Control, AxHostNotifyIcon 클래스에 대해 존재 합니다.These three events exist for the Control, AxHost, and NotifyIcon classes.

이벤트 모델에 대 한 자세한 내용은 이벤트 처리 및 발생합니다.For information about the event model, see Handling and Raising Events.


MouseEventArgs(MouseButtons, Int32, Int32, Int32, Int32) MouseEventArgs 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the MouseEventArgs class.



누른 마우스 단추를 나타내는 값을 가져옵니다.Gets which mouse button was pressed.


마우스 단추를 눌렀다 놓은 횟수를 가져옵니다.Gets the number of times the mouse button was pressed and released.


마우스 휠의 회전 수를 나타내는 부호 있는 숫자에 WHEEL_DELTA 상수를 곱한 값을 가져옵니다.Gets a signed count of the number of detents the mouse wheel has rotated, multiplied by the WHEEL_DELTA constant. 회전이란 마우스 휠을 한 번 돌리는 것입니다.A detent is one notch of the mouse wheel.


마우스 이벤트를 생성하는 동안 마우스의 위치를 가져옵니다.Gets the location of the mouse during the generating mouse event.


마우스 이벤트를 생성하는 동안 마우스의 x좌표를 가져옵니다.Gets the x-coordinate of the mouse during the generating mouse event.


마우스 이벤트를 생성하는 동안 마우스의 y좌표를 가져옵니다.Gets the y-coordinate of the mouse during the generating mouse event.



지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

적용 대상

추가 정보