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

MouseEventArgs コンストラクタ

MouseEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    button As MouseButtons, _
    clicks As Integer, _
    x As Integer, _
    y As Integer, _
    delta As Integer _
)

Visual Basic (使用法)

Dim button As MouseButtons
Dim clicks As Integer
Dim x As Integer
Dim y As Integer
Dim delta As Integer

Dim instance As New MouseEventArgs(button,
 clicks, x, y, delta)

C#

public MouseEventArgs (
    MouseButtons button,
    int clicks,
    int x,
    int y,
    int delta
)

C++

public:
MouseEventArgs (
    MouseButtons button, 
    int clicks, 
    int x, 
    int y, 
    int delta
)

J#

public MouseEventArgs (
    MouseButtons button, 
    int clicks, 
    int x, 
    int y, 
    int delta
)

JScript

public function MouseEventArgs (
    button : MouseButtons, 
    clicks : int, 
    x : int, 
    y : int, 
    delta : int
)

パラメータ

button

押されたマウス ボタンを示す MouseButtons 値の 1 つ。

clicks

マウス ボタンが押された回数。

x

マウスがクリックされた位置の x 座標 (ピクセル単位)。

y

delta

マウス ホイールの回転回数を表す符合付きの数値。

プラットフォーム

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 クラス
MouseEventArgs メンバ
System.Windows.Forms 名前空間
MouseButtons 列挙体
Delta

MouseEventArgs プロパティ

パブリック プロパティ

	名前	説明
	Y	マウス イベント生成時のマウスの y 座標を取得します。

参照

関連項目

MouseEventArgs クラス
System.Windows.Forms 名前空間
OnMouseDown
Control.MouseDown イベント
OnMouseUp
Control.MouseUp イベント
OnMouseMove
Control.MouseMove イベント
MouseDown
MouseUp
MouseMove

MouseEventArgs メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

MouseEventArgs クラス
System.Windows.Forms 名前空間
OnMouseDown
Control.MouseDown イベント
OnMouseUp
Control.MouseUp イベント
OnMouseMove
Control.MouseMove イベント
MouseDown
MouseUp
MouseMove

MouseEventArgs メンバ

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

MouseEventArgs データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	MouseEventArgs	MouseEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Y	マウス イベント生成時のマウスの y 座標を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

MouseEventArgs クラス
System.Windows.Forms 名前空間
OnMouseDown
Control.MouseDown イベント
OnMouseUp
Control.MouseUp イベント
OnMouseMove
Control.MouseMove イベント
MouseDown
MouseUp
MouseMove