Control.Click イベント

定義

コントロールがクリックされたときに発生します。Occurs when the control is clicked.

public:
 event EventHandler ^ Click;
public event EventHandler Click;
member this.Click : EventHandler 
Public Custom Event Click As EventHandler 

次のコード例は、イベントハンドラーの Click イベントを示しています。The following code example shows the Click event in an event handler.

   // 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 handler 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;
   }
// 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 handler 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;
}
' 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 handler 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

注釈

Click イベントは、EventArgs をそのイベントハンドラーに渡します。そのため、クリックが発生したことのみを示します。The Click event passes an EventArgs to its event handler, so it only indicates that a click has occurred. マウスの特定の情報 (ボタン、クリック数、ホイール回転、位置など) が必要な場合は、MouseClick イベントを使用します。If you need more specific mouse information (button, number of clicks, wheel rotation, or location), use the MouseClick event. ただし、ENTER キーを押すなど、マウス以外の操作によってクリックが発生した場合、MouseClick イベントは発生しません。However, the MouseClick event will not be raised if the click is caused by action other than that of the mouse, such as pressing the ENTER key.

ダブルクリックは、ユーザーのオペレーティングシステムのマウス設定によって決まります。A double-click is determined by the mouse settings of the user's operating system. ユーザーは、2 回のクリックではなくダブルクリックと見なされるマウス ボタンのクリック間隔を設定できます。The user can set the time between clicks of a mouse button that should be considered a double-click rather than two clicks. Click イベントは、コントロールがダブルクリックされるたびに発生します。The Click event is raised every time a control is double-clicked. たとえば、FormClick および DoubleClick イベントのイベントハンドラーがある場合、フォームがダブルクリックされ、両方のメソッドが呼び出されると、ClickDoubleClick のイベントが発生します。For example, if you have event handlers for the Click and DoubleClick events of a Form, the Click and DoubleClick events are raised when the form is double-clicked and both methods are called. コントロールがダブルクリックされ、そのコントロールが DoubleClick イベントをサポートしていない場合、Click イベントが2回発生する可能性があります。If a control is double-clicked and that control does not support the DoubleClick event, the Click event might be raised twice.

このイベントを発生させるには、ControlStylesStandardClick 値を true に設定する必要があります。You must set the StandardClick value of ControlStyles to true for this event to be raised.

注意

TabControl.TabPages コレクションに少なくとも1つの TabPage が含まれている場合 (ClickDoubleClickMouseDownMouseUpMouseHoverMouseEnterMouseLeaveMouseMove)、TabControl クラスでは、次のイベントは発生しません。The following events are not raised for the TabControl class unless there is at least one TabPage in the TabControl.TabPages collection: Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnter, MouseLeave and MouseMove. コレクションに少なくとも1つの TabPage が存在し、ユーザーがタブコントロールのヘッダー (TabPage 名が表示される) と対話する場合、TabControl は適切なイベントを発生させます。If there is at least one TabPage in the collection, and the user interacts with the tab control's header (where the TabPage names appear), the TabControl raises the appropriate event. ただし、ユーザーの操作がタブページのクライアント領域内にある場合、TabPage は適切なイベントを発生させます。However, if the user interaction is within the client area of the tab page, the TabPage raises the appropriate event.

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。For more information about handling events, see Handling and Raising Events.

継承に関する注意事項Notes to inheritors

標準 Windows フォーム制御から継承し、ControlStylesStandardClick または StandardDoubleClick 値を true に変更すると、予期しない動作が発生したり、コントロールで Click イベントまたは DoubleClick イベントがサポートされていない場合はまったく効果がなくなります。Inheriting from a standard Windows Forms control and changing the StandardClick or StandardDoubleClick values of ControlStyles to true can cause unexpected behavior or have no effect at all if the control does not support the Click or DoubleClick events.

次の表は、Windows フォームコントロールと、指定されたマウス操作に応答して発生するイベント (Click または DoubleClick) を示しています。The following table lists Windows Forms controls and which event (Click or DoubleClick) is raised in response to the mouse action specified.

ControlControl マウスの左クリックLeft Mouse Click マウスの左ダブルクリックLeft Mouse Double Click マウスの右クリックRight Mouse Click 右マウスダブルクリックRight Mouse Double Click マウスの中央クリックMiddle Mouse Click 中央マウスダブルクリックMiddle Mouse Double Click XButton1 マウスクリックXButton1 Mouse Click XButton1 マウスのダブルクリックXButton1 Mouse Double-Click XButton2 マウスクリックXButton2 Mouse Click XButton2 マウスのダブルクリックXButton2 Mouse Double-Click
MonthCalendar, DateTimePicker, HScrollBar, VScrollBarMonthCalendar, DateTimePicker, HScrollBar, VScrollBar nonenone nonenone nonenone nonenone nonenone nonenone nonenone nonenone nonenone nonenone
Button, CheckBox, RichTextBox, RadioButtonButton, CheckBox, RichTextBox, RadioButton ここをClick をクリックし、Click, Click nonenone nonenone nonenone nonenone nonenone nonenone nonenone nonenone
ListBoxCheckedListBoxComboBoxListBox, CheckedListBox, ComboBox ここをClick [, DoubleClick] をクリックします。Click, DoubleClick nonenone nonenone nonenone nonenone nonenone nonenone nonenone nonenone
TextBoxDomainUpDownNumericUpDownTextBox, DomainUpDown, NumericUpDown ここをClick [, DoubleClick] をクリックします。Click, DoubleClick nonenone nonenone nonenone nonenone nonenone nonenone nonenone nonenone
* TreeView、* ListView* TreeView, * ListView ここをClick [, DoubleClick] をクリックします。Click, DoubleClick ここをClick [, DoubleClick] をクリックします。Click, DoubleClick nonenone nonenone nonenone nonenone nonenone nonenone
ProgressBarTrackBarProgressBar, TrackBar ここをClick をクリックし、Click, Click ここをClick をクリックし、Click, Click ここをClick をクリックし、Click, Click ここをClick をクリックし、Click, Click ここをClick をクリックし、Click, Click
FormDataGridLabelLinkLabelPanelGroupBoxPictureBoxSplitterStatusBarToolBarTabPage、** TabControlForm, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl ここをClick [, DoubleClick] をクリックします。Click, DoubleClick ここをClick [, DoubleClick] をクリックします。Click, DoubleClick ここをClick [, DoubleClick] をクリックします。Click, DoubleClick ここをClick [, DoubleClick] をクリックします。Click, DoubleClick ここをClick [, DoubleClick] をクリックします。Click, DoubleClick

マウスポインターが子オブジェクト (TreeNode または ListViewItem) 上にある必要がある * ます。* The mouse pointer must be over a child object (TreeNode or ListViewItem).

* * TabControl には、TabPages コレクションに少なくとも1つの TabPage が必要です。** The TabControl must have at least one TabPage in its TabPages collection.

適用対象

こちらもご覧ください