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) の一覧を次に示します。

コントロール	左マウス クリック	左マウス ダブルクリック	右マウス クリック	右マウス ダブルクリック	中央マウス クリック	中央マウス ダブルクリック	XButton1 マウス クリック	XButton1 マウス ダブルクリック	XButton2 マウス クリック	XButton2 マウス ダブルクリック
MonthCalendar, DateTimePicker, RichTextBox, HScrollBar, VScrollBar	なし	なし	なし	なし	なし	なし	なし	なし	なし	なし
Button, CheckBox, RadioButton	Click	Click, Click	なし	なし	なし	なし	なし	なし	なし	なし
ListBox, CheckedListBox, ComboBox	Click	Click, DoubleClick	なし	なし	なし	なし	なし	なし	なし	なし
TextBox, DomainUpDown, NumericUpDown	Click	Click, DoubleClick	なし	なし	なし	なし	なし	なし	なし	なし
* TreeView, * ListView	Click	Click, DoubleClick	Click	Click, DoubleClick	なし	なし	なし	なし	なし	なし
ProgressBar, TrackBar	Click	Click, Click	Click	Click, Click	Click	Click, Click	Click	Click, Click	Click	Click, Click
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	Click	Click, DoubleClick	Click	Click, DoubleClick	Click	Click, DoubleClick	Click	Click, DoubleClick	Click	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