Control.Click Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Se produit suite à un clic sur le contrôle.

public:
 event EventHandler ^ Click;

public event EventHandler? Click;

member this.Click : EventHandler 

Public Custom Event Click As EventHandler 

Type d'événement

EventHandler

Exemples

L’exemple de code suivant montre l’événement Click dans un gestionnaire d’événements.

   // 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

Remarques

L’événement Click passe un à son gestionnaire d’événements EventArgs , il indique donc uniquement qu’un clic s’est produit. Si vous avez besoin d’informations plus spécifiques sur la souris (bouton, nombre de clics, rotation de roue ou emplacement), utilisez l’événement MouseClick . Toutefois, l’événement MouseClick ne sera pas déclenché si le clic est provoqué par une action autre que celle de la souris, par exemple en appuyant sur la touche ENTRÉE.

Un double-clic est déterminé par les paramètres de la souris du système d’exploitation de l’utilisateur. L'utilisateur peut définir le délai qui détermine si les clics effectués sur un bouton de souris sont considérés comme un double-clic ou comme deux clics. L’événement Click est déclenché chaque fois qu’un contrôle est double-cliqué. Par exemple, si vous avez des gestionnaires d’événements pour les Click événements et DoubleClick d’un Form, les Click événements et DoubleClick sont déclenchés lorsque le formulaire est double-cliqué et que les deux méthodes sont appelées. Si un contrôle est double-cliqué et que ce contrôle ne prend pas en charge l’événement DoubleClick , l’événement Click peut être déclenché deux fois.

Vous devez définir la StandardClick valeur de ControlStyles sur true pour que cet événement soit déclenché.

Notes

Les événements suivants ne sont pas déclenchés pour la TabControl classe, sauf s’il en existe au moins un TabPage dans la TabControl.TabPages collection : Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnteret MouseLeaveMouseMove. S’il y en a au moins un TabPage dans la collection et que l’utilisateur interagit avec l’en-tête du contrôle d’onglet (où les TabPage noms apparaissent), le TabControl déclenche l’événement approprié. Toutefois, si l’interaction de l’utilisateur se trouve dans la zone cliente de la page d’onglet, le TabPage déclenche l’événement approprié.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

Remarques à l’attention des héritiers

L’héritage d’un contrôle Windows Forms standard et la StandardClick modification des valeurs ou StandardDoubleClick de ControlStyles à peuvent true entraîner un comportement inattendu ou n’avoir aucun effet du tout si le contrôle ne prend pas en charge les Click événements ou DoubleClick .

Le tableau suivant répertorie Windows Forms contrôles et l’événement (Click ou DoubleClick) qui est déclenché en réponse à l’action de la souris spécifiée.

Control	Clic gauche de la souris	Double-clic gauche de la souris	Clic droit de la souris	Double-clic de la souris avec le bouton droit	Clic au milieu de la souris	Double-clic de la souris centrale	XButton1 Clic de souris	Double-Click souris XButton1	XButton2 Clic de souris	Double-Click de souris XButton2
MonthCalendar, DateTimePicker, HScrollBar, VScrollBar	aucun	aucun	aucun	aucun	aucun	aucun	aucun	aucun	aucun	aucun
Button, CheckBox, RichTextBox, RadioButton	Cliquez	Cliquez, cliquez sur	aucun	aucun	aucun	aucun	aucun	aucun	aucun	aucun
ListBox, CheckedListBox, ComboBox	Cliquez	Cliquez sur, DoubleClick	aucun	aucun	aucun	aucun	aucun	aucun	aucun	aucun
TextBox, DomainUpDown, NumericUpDown	Cliquez	Cliquez sur, DoubleClick	aucun	aucun	aucun	aucun	aucun	aucun	aucun	aucun
* TreeView, * ListView	Cliquez	Cliquez sur, DoubleClick	Cliquez	Cliquez sur, DoubleClick	aucun	aucun	aucun	aucun	aucun	aucun
ProgressBar, TrackBar	Cliquez	Cliquez, cliquez sur	Cliquez	Cliquez, cliquez sur	Cliquez	Cliquez, cliquez sur	Cliquez	Cliquez, cliquez sur	Cliquez	Cliquez, cliquez sur
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	Cliquez	Cliquez sur, DoubleClick	Cliquez	Cliquez sur, DoubleClick	Cliquez	Cliquez sur, DoubleClick	Cliquez	Cliquez sur, DoubleClick	Cliquez	Cliquer, DoubleClick

* Le pointeur de la souris doit se trouver sur un objet enfant (TreeNode ou ListViewItem).

** Le TabControl doit avoir au moins un TabPage dans sa TabPages collection.

Voir aussi

• OnClick(EventArgs)
• StandardClick
• MouseClick
• DoubleClick
• MouseDoubleClick