Control.MouseClick Événement

Définition

Se produit après un clic de souris sur le contrôle.Occurs when the control is clicked by the mouse.

public:
 event System::Windows::Forms::MouseEventHandler ^ MouseClick;
public event System.Windows.Forms.MouseEventHandler MouseClick;
member this.MouseClick : System.Windows.Forms.MouseEventHandler 
Public Custom Event MouseClick As MouseEventHandler 

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.The following code example demonstrates the use of this member. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement MouseClick.In the example, an event handler reports on the occurrence of the MouseClick event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour signaler plusieurs événements ou sur des événements qui se produisent fréquemment, envisagez de remplacer MessageBox.Show par Console.WriteLine ou d’ajouter le message à un TextBox multiligne.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance d’un type qui hérite de Control, tel qu’un Button ou ComboBox.To run the example code, paste it into a project that contains an instance of a type that inherits from Control, such as a Button or ComboBox. Nommez ensuite l’instance Control1 et assurez-vous que le gestionnaire d’événements est associé à l’événement MouseClick.Then name the instance Control1 and ensure that the event handler is associated with the MouseClick event.

private void Control1_MouseClick(Object sender, MouseEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Button", e.Button );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Clicks", e.Clicks );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Delta", e.Delta );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Location", e.Location );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MouseClick Event" );
}
Private Sub Control1_MouseClick(sender as Object, e as MouseEventArgs) _ 
     Handles Control1.MouseClick

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Button", e.Button)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Clicks", e.Clicks)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Delta", e.Delta)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Location", e.Location)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"MouseClick Event")

End Sub

Remarques

Si vous décochez un bouton de la souris lorsque le curseur se trouve sur un contrôle, vous déclenchez généralement la série d’événements suivante à partir du contrôle :Depressing a mouse button when the cursor is over a control typically raises the following series of events from the control:

  1. ÉvénementMouseDown .MouseDown event.

  2. ÉvénementClick .Click event.

  3. ÉvénementMouseClick .MouseClick event.

  4. ÉvénementMouseUp .MouseUp event.

Pour que cela se produise, les différents événements ne peuvent pas être désactivés dans la classe du contrôle.For this to occur, the various events cannot be disabled in the control's class.

Deux clics uniques qui se produisent suffisamment près dans le temps, tels que déterminés par les paramètres de la souris du système d’exploitation de l’utilisateur, génèrent un événement MouseDoubleClick au lieu du deuxième événement MouseClick.Two single clicks that occur close enough in time, as determined by the mouse settings of the user's operating system, will generate a MouseDoubleClick event instead of the second MouseClick event.

Important

les événements Click sont logiquement des événements de niveau supérieur d’un contrôle.Click events are logically higher-level events of a control. Ils sont souvent déclenchés par d’autres actions, par exemple en appuyant sur la touche entrée lorsque le contrôle a le focus.They are often raised by other actions, such as pressing the ENTER key when the control has focus.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à

Voir aussi