Control.Click イベント

コントロールがクリックされたときに発生します。

Public Event Click As EventHandler
[C#]
public event EventHandler Click;
[C++]
public: __event EventHandler* Click;

[JScript] JScript では、このクラスで定義されているイベントを処理できます。ただし、独自に定義することはできません。

イベント データ

イベント ハンドラが EventArgs 型の引数を受け取りました。

解説

Click イベントは EventArgs オブジェクトをそのイベント ハンドラに渡します。これは、クリックが発生したことを示すにすぎません。マウスの関するより詳細な情報、たとえば、ボタン、クリック回数、ホイール回転、位置などの情報が必要な場合は、 MouseEventArgs オブジェクトをイベント ハンドラに渡す MouseDown イベントと MouseUp イベントを使用します。

ユーザーのオペレーティング システムのマウス設定に応じて、ダブルクリックが決定されます。ユーザーは、2 回のクリックではなくダブルクリックと見なされるマウス ボタンのクリック間隔を設定できます。 Click イベントは、コントロールがダブルクリックされるたびに発生します。たとえば、 Form の Click イベントおよび DoubleClick イベントに対してそれぞれイベント処理メソッドがある場合は、フォームがダブルクリックされ両方のメソッドが呼び出されると Click イベントと DoubleClick イベントが発生します。ダブルクリックされたコントロールが DoubleClick イベントをサポートしていない場合は、 Click イベントが 2 回発生することがあります。

このイベントを発生させるには、 ControlStyles.StandardClick スタイル ビットを true に設定する必要があります。

継承時の注意: 標準の Windows フォーム コントロールから継承し、 StandardClick ビット値または StandardDoubleClick ビット値を true に変更すると、コントロールが Click イベントまたは DoubleClick イベントをサポートしていない場合は、予測できない動作が行われたり、何の効果も得られなかったりします。

Windows フォーム コントロールと、指定したマウス アクションに対して発生するイベント (Click または DoubleClick) の一覧を次に示します。

* マウス ポインタが子オブジェクト (TreeNode または ListViewItem) の上になければなりません。

** TabControl には、 TabPages コレクション内に少なくとも 1 つの TabPage が必要です。

メモ    Click 、 DoubleClick 、 MouseDown 、 MouseUp 、 MouseHover 、 MouseEnter 、 MouseLeave 、 MouseMove の各イベントは、 TabControl.TabPages コレクションに 1 つ以上の TabPage が存在しない限り、 TabControl クラスで生成されません。コレクションに 1 つ以上の TabPage があり、ユーザーがタブ コントロールのヘッダー (TabPage の名前が表示される場所) と対話すると、 TabControl が適切なイベントを発生させます。ただし、ユーザーとの対話がタブ ページのクライアント領域内の場合、 TabPage は該当するイベントを発生させます。

イベント処理の詳細については、「 イベントの利用 」を参照してください。

使用例

 
' This example uses the Parent property and the Find method of Control to set
' properties on the parent control of a Button and its Form. The example assumes
' that a Button control named button1 is located within a GroupBox control. The 
' example also assumes that the Click event of the Button control is connected to
' the event handling method defined in the example.
Private Sub button1_Click(sender As Object, e As System.EventArgs) Handles button1.Click
   ' Get the control the Button control is located in. In this case a GroupBox.
   Dim control As Control = button1.Parent
   ' Set the text and backcolor of the parent control.
   control.Text = "My Groupbox"
   control.BackColor = Color.Blue
   ' Get the form that the Button control is contained within.
   Dim myForm As Form = button1.FindForm()
   ' Set the text and color of the form containing the Button.
   myForm.Text = "The Form of My Control"
   myForm.BackColor = Color.Red
End Sub

[C#] 
// This example uses the Parent property and the Find method of Control to set
// properties on the parent control of a Button and its Form. The example assumes
// that a Button control named button1 is located within a GroupBox control. The 
// example also assumes that the Click event of the Button control is connected to
// the event handling method defined in the example.
private void button1_Click(object sender, System.EventArgs e)
{
   // Get the control the Button control is located in. In this case a GroupBox.
   Control control = button1.Parent;
   // Set the text and backcolor of the parent control.
   control.Text = "My Groupbox";
   control.BackColor = Color.Blue;
   // Get the form that the Button control is contained within.
   Form myForm = button1.FindForm();
   // Set the text and color of the form containing the Button.
   myForm.Text = "The Form of My Control";
   myForm.BackColor = Color.Red;
}

[C++] 
// This example uses the Parent property and the Find method of Control to set
// properties on the parent control of a Button and its Form. The example assumes
// that a Button control named button1 is located within a GroupBox control. The 
// example also assumes that the Click event of the Button control is connected to
// the event handling method defined in the example.
private:
void button1_Click(Object* /*sender*/, System::EventArgs* /*e*/)
{
   // Get the control the Button control is located in. In this case a GroupBox.
   Control* control = button1->Parent;
   // Set the text and backcolor of the parent control.
   control->Text = S"My Groupbox";
   control->BackColor = Color::Blue;
   // Get the form that the Button control is contained within.
   Form* myForm = button1->FindForm();
   // Set the text and color of the form containing the Button.
   myForm->Text = S"The Form of My Control";
   myForm->BackColor = Color::Red;
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | OnClick | StandardClick