MouseEventArgs クラス

.NET Framework クラス ライブラリ リファレンス

MouseEventArgs クラス

MouseUp、MouseDown、MouseMove の各イベントのデータを提供します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class MouseEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As MouseEventArgs

C#

[ComVisibleAttribute(true)] 
public class MouseEventArgs : EventArgs

C++

[ComVisibleAttribute(true)] 
public ref class MouseEventArgs : public
 EventArgs

J#

/** @attribute ComVisibleAttribute(true) */ 
public class MouseEventArgs extends EventArgs

JScript

ComVisibleAttribute(true) 
public class MouseEventArgs extends
 EventArgs

解説

MouseDown イベントは、ポインタがコントロールの上にあるときにユーザーがマウス ボタンを押すと発生します。MouseUp イベントは、ポインタがコントロールの上にあるときにユーザーがマウス ボタンを離すと発生します。MouseMoveイベントは、ユーザーがマウス ポインタをコントロール上に移動すると発生します。MouseEventArgs は、押されたマウス ボタン、押されて離された回数、マウスの位置の座標、およびマウス ホイールによる移動量を指定します。

ユーザーがマウス ボタンを離す前に他のアプリケーションにフォーカスを移動した場合は、対応する MouseUp がなくても MouseDown イベントを受け取ることができます。

この 3 つのイベントは、Control、AxHost、NotifyIcon の各クラスに存在します。

イベント モデルの詳細については、「イベントとデリゲート」を参照してください。

使用例

TextBox コントロールの MouseDown イベントを処理して、マウスの右ボタンをクリックするとコントロール内のすべてのテキストが選択されるようにするコード例を次に示します。この例では、textBox1 という名前の TextBox コントロールがフォームに配置されている必要があります。

Visual Basic

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

C#

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);
    }
}

Location プロパティを使用してマウスの左クリックを追跡し、ユーザーの入力に応答して一連の線分を描画するコード例を次に示します。この例では、フォームを非表示にした後に再度表示しても、線分が再描画されることはありません。このコードは簡素化のために省略されています。

Visual Basic

Dim FirstPoint As Point
Dim HaveFirstPoint As Boolean
 = False

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

C#

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;
    }
}

X プロパティと Y プロパティを使用して、マウス ポインタの現在位置を ToolTip ウィンドウに表示するコード例を次に示します。

Visual Basic

Dim TrackTip As ToolTip

Private Sub TrackCoordinates()
    TrackTip = New ToolTip()
End Sub

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

C#

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);
}

継承階層

System.Object
   System.EventArgs
    System.Windows.Forms.MouseEventArgs
       System.Windows.Forms.DataGridViewCellMouseEventArgs
       System.Windows.Forms.HandledMouseEventArgs
       System.Windows.Forms.StatusBarPanelClickEventArgs
       System.Windows.Forms.TreeNodeMouseClickEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
MouseEventArgs メンバ
System.Windows.Forms 名前空間
OnMouseDown
Control.MouseDown イベント
OnMouseUp
Control.MouseUp イベント
OnMouseMove
Control.MouseMove イベント
MouseDown
MouseUp
MouseMove