Control.Click Control.Click Control.Click Control.Click Event

Определение

Происходит при щелчке элемента управления.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. Тем не менее 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. Пользователь может задать время между нажатиями кнопки мыши, которые будут считаться двойным щелчком, а не двумя отдельными щелчками.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. Например, если у вас есть обработчики событий для Click и DoubleClick события Form, Click и DoubleClick событий при двойном щелчке формы и вызове обоих методов.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 событие может вызываться дважды.If a control is double-clicked and that control does not support the DoubleClick event, the Click event might be raised twice.

Необходимо задать StandardClick значение ControlStyles для true для возникновения этого события.You must set the StandardClick value of ControlStyles to true for this event to be raised.

Примечание

Следующие события не вызываются для TabControl класса, если имеется по крайней мере один TabPage в TabControl.TabPages коллекции: Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnter, MouseLeave и MouseMove.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. Если имеется по крайней мере один TabPage в коллекции, и пользователь взаимодействует с заголовка элемента управления tab (где 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.

Примечания для тех, кто наследует этот метод

Наследование от стандартного элемента управления Windows Forms и замена StandardClick или StandardDoubleClick значения ControlStyles для 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 Forms и какое событие (Click или DoubleClick) вызывается в ответ на указанное действие мыши.The following table lists Windows Forms controls and which event (Click or DoubleClick) is raised in response to the mouse action specified.

Элемент управленияControl Щелчок левой кнопкой мышиLeft Mouse Click Двойной щелчок левой кнопкой мышиLeft Mouse Double Click Щелкните правой кнопкой мышиRight Mouse Click Дважды щелкните правой кнопкой мышиRight Mouse Double Click Щелчок средней кнопкой мышиMiddle Mouse Click Двойной щелчок средней кнопкой мышиMiddle Mouse Double Click Нажмите кнопку мыши XButton1XButton1 Mouse Click Мыши XButton1XButton1 Mouse Double-Click Щелчок мыши XButton2XButton2 Mouse Click Мыши xbutton2XButton2 Mouse Double-Click
MonthCalendar,MonthCalendar, DateTimePicker,DateTimePicker, HScrollBar,HScrollBar, VScrollBar Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
Button,Button, CheckBox,CheckBox, RichTextBox,RichTextBox, RadioButton Нажмите кнопкуClick Нажмите кнопку, нажмите кнопкуClick, Click Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
ListBox,ListBox, CheckedListBox,CheckedListBox, ComboBox Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
TextBox,TextBox, DomainUpDown,DomainUpDown, NumericUpDown Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
\* TreeView,\* TreeView, \* ListView\* ListView Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
ProgressBar,ProgressBar, TrackBar Нажмите кнопкуClick Нажмите кнопку, нажмите кнопкуClick, Click Нажмите кнопкуClick Нажмите кнопку, нажмите кнопкуClick, Click Нажмите кнопкуClick Нажмите кнопку, нажмите кнопкуClick, Click Нажмите кнопкуClick Нажмите кнопку, нажмите кнопкуClick, Click Нажмите кнопкуClick Нажмите кнопку, нажмите кнопкуClick, Click
Form,Form, DataGrid,DataGrid, Label,Label, LinkLabel,LinkLabel, Panel,Panel, GroupBox,GroupBox, PictureBox,PictureBox, Splitter,Splitter, StatusBar,StatusBar, ToolBar,ToolBar, TabPage,TabPage, ** TabControl Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick

* Указатель мыши должен быть на дочернем объекте (TreeNode или ListViewItem).* The mouse pointer must be over a child object (TreeNode or ListViewItem).

** TabControl Должен иметь по крайней мере TabPage в его TabPages коллекции.** The TabControl must have at least one TabPage in its TabPages collection.

Применяется к

Дополнительно