Control.Click Ereignis

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Tritt beim Klicken auf das Steuerelement ein.

public:
 event EventHandler ^ Click;

public event EventHandler? Click;

member this.Click : EventHandler 

Public Custom Event Click As EventHandler 

Ereignistyp

EventHandler

Beispiele

Das folgende Codebeispiel zeigt das Click Ereignis in einem Ereignishandler.

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

Hinweise

Das Click Ereignis übergibt einen EventArgs an seinen Ereignishandler, sodass es nur angibt, dass ein Klick aufgetreten ist. Wenn Sie spezifischere Mausinformationen benötigen (Schaltfläche, Anzahl der Klicks, Raddrehung oder Position), verwenden Sie das MouseClick Ereignis. Das Ereignis wird jedoch nicht ausgelöst, MouseClick wenn das Klicken durch eine andere Aktion als die der Maus verursacht wird, z. B. das Drücken der EINGABETASTE.

Ein Doppelklick wird durch die Mauseinstellungen des Betriebssystems des Benutzers bestimmt. Der Benutzer kann den Zeitraum festlegen, innerhalb dessen der zweite Mausklick erfolgen muss, damit zwei aufeinander folgende Mausklicks als Doppelklick erkannt werden. Das Click Ereignis wird jedes Mal ausgelöst, wenn auf ein Steuerelement doppelt geklickt wird. Wenn Sie beispielsweise über Ereignishandler für die Click Ereignisse und DoubleClick eines Formverfügen, werden die Click Ereignisse und DoubleClick ausgelöst, wenn auf das Formular doppelt geklickt wird und beide Methoden aufgerufen werden. Wenn auf ein Steuerelement doppelt geklickt wird und dieses Steuerelement das DoubleClick Ereignis nicht unterstützt, wird das Click Ereignis möglicherweise zweimal ausgelöst.

Sie müssen den StandardClick Wert von ControlStyles auf festlegen, true damit dieses Ereignis ausgelöst wird.

Hinweis

Die folgenden Ereignisse werden für die TabControl -Klasse nur ausgelöst, wenn mindestens eins TabPage in der TabControl.TabPages Auflistung vorhanden ist: Click, , DoubleClickMouseDown, MouseUp, MouseHover, MouseEnterMouseLeave und MouseMove. Wenn mindestens eine TabPage in der Auflistung vorhanden ist und der Benutzer mit dem Header des Registerkartensteuerelements interagiert (in dem die TabPage Namen angezeigt werden), löst das TabControl das entsprechende Ereignis aus. Wenn sich die Benutzerinteraktion jedoch im Clientbereich der Registerkartenseite befindet, löst das TabPage das entsprechende Ereignis aus.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Hinweise zu Erben

Das Erben von einem Standard-Windows Forms-Steuerelements und das Ändern der StandardClick Werte oder StandardDoubleClick von ControlStyles in true kann unerwartetes Verhalten verursachen oder überhaupt keine Auswirkungen haben, wenn das Steuerelement die Click Ereignisse oder DoubleClick nicht unterstützt.

In der folgenden Tabelle sind Windows Forms Steuerelemente aufgeführt und welches Ereignis (Click oder DoubleClick) als Reaktion auf die angegebene Mausaktion ausgelöst wird.

Control	Klicken Sie mit der linken Maustaste	Doppelklick mit der linken Maustaste	Klicken Sie mit der rechten Maustaste	Doppelklicken mit der rechten Maustaste	Mittlerer Mausklick	Doppelklick mit der mittleren Maus	XButton1 Mausklick	XButton1 Mouse Double-Click	XButton2 Mausklick	XButton2 Mouse Double-Click
MonthCalendar, DateTimePicker, HScrollBar, VScrollBar	Keine	Keine	Keine	Keine	Keine	Keine	Keine	Keine	Keine	Keine
Button, CheckBox, RichTextBox, RadioButton	Klicken Sie auf	Klicken, Klicken	Keine	Keine	Keine	Keine	Keine	Keine	Keine	Keine
ListBox, CheckedListBox, ComboBox	Klicken Sie auf	Klicken, Doppelklicken	Keine	Keine	Keine	Keine	Keine	Keine	Keine	Keine
TextBox, DomainUpDown, NumericUpDown	Klicken Sie auf	Klicken, Doppelklicken	Keine	Keine	Keine	Keine	Keine	Keine	Keine	Keine
* TreeView, * ListView	Klicken Sie auf	Klicken, Doppelklicken	Klicken Sie auf	Klicken, Doppelklicken	Keine	Keine	Keine	Keine	Keine	Keine
ProgressBar, TrackBar	Klicken Sie auf	Klicken, Klicken	Klicken Sie auf	Klicken, Klicken	Klicken Sie auf	Klicken, Klicken	Klicken Sie auf	Klicken, Klicken	Klicken Sie auf	Klicken, Klicken
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	Klicken Sie auf	Klicken, Doppelklicken	Klicken Sie auf	Klicken, Doppelklicken	Klicken Sie auf	Klicken, Doppelklicken	Klicken Sie auf	Klicken, Doppelklicken	Klicken Sie auf	Klicken Sie, DoubleClick

* Der Mauszeiger muss sich über einem untergeordneten Objekt (TreeNode oder ListViewItem) bewegen.

** Die TabControl muss mindestens einen TabPage in seiner TabPages Sammlung enthalten.

Weitere Informationen

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