Control.DoubleClick Control.DoubleClick Control.DoubleClick Control.DoubleClick Event

Definition

Tritt beim Doppelklicken auf das Steuerelement ein.Occurs when the control is double-clicked.

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

Beispiele

Im folgenden Codebeispiel wird das DoubleClick -Ereignis ListBox eines verwendet, um die in der ListBox aufgelisteten Textdateien TextBox in ein-Steuerelement zu laden.The following code example uses the DoubleClick event of a ListBox to load text files listed in the ListBox into a TextBox control.

   // This example uses the DoubleClick event of a ListBox to load text files
   // listed in the ListBox into a TextBox control. This example
   // assumes that the ListBox, named listBox1, contains a list of valid file
   // names with path and that this event handler method
   // is connected to the DoublClick event of a ListBox control named listBox1.
   // This example requires code access permission to access files.
private:
   void listBox1_DoubleClick( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Get the name of the file to open from the ListBox.
      String^ file = listBox1->SelectedItem->ToString();
      try
      {
         // Determine if the file exists before loading.
         if ( System::IO::File::Exists( file ) )
         {
            
            // Open the file and use a TextReader to read the contents into the TextBox.
            System::IO::FileInfo^ myFile = gcnew System::IO::FileInfo( listBox1->SelectedItem->ToString() );
            System::IO::TextReader^ myData = myFile->OpenText();
            ;
            textBox1->Text = myData->ReadToEnd();
            myData->Close();
         }
      }
      // Exception is thrown by the OpenText method of the FileInfo class.
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "The file you specified does not exist." );
      }
      // Exception is thrown by the ReadToEnd method of the TextReader class.
      catch ( System::IO::IOException^ ) 
      {
         MessageBox::Show( "There was a problem loading the file into the TextBox. Ensure that the file is a valid text file." );
      }
   }
// This example uses the DoubleClick event of a ListBox to load text files
// listed in the ListBox into a TextBox control. This example
// assumes that the ListBox, named listBox1, contains a list of valid file
// names with path and that this event handler method
// is connected to the DoublClick event of a ListBox control named listBox1.
// This example requires code access permission to access files.
private void listBox1_DoubleClick(object sender, System.EventArgs e)
{
    // Get the name of the file to open from the ListBox.
    String file = listBox1.SelectedItem.ToString();

    try
    {
        // Determine if the file exists before loading.
        if (System.IO.File.Exists(file))
        {
            // Open the file and use a TextReader to read the contents into the TextBox.
            System.IO.FileInfo myFile = new System.IO.FileInfo(listBox1.SelectedItem.ToString());
            System.IO.TextReader myData = myFile.OpenText();;

            textBox1.Text = myData.ReadToEnd();
            myData.Close();
        }
    }
        // Exception is thrown by the OpenText method of the FileInfo class.
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("The file you specified does not exist.");
    }
        // Exception is thrown by the ReadToEnd method of the TextReader class.
    catch(System.IO.IOException)
    {
        MessageBox.Show("There was a problem loading the file into the TextBox. Ensure that the file is a valid text file.");
    }
}
' This example uses the DoubleClick event of a ListBox to load text files  
' listed in the ListBox into a TextBox control. This example
' assumes that the ListBox, named listBox1, contains a list of valid file 
' names with path and that this event handler method
' is connected to the DoublClick event of a ListBox control named listBox1.
' This example requires code access permission to access files.
Private Sub listBox1_DoubleClick(ByVal sender As Object, ByVal e As System.EventArgs) Handles listBox1.DoubleClick
    ' Get the name of the file to open from the ListBox.
    Dim file As [String] = listBox1.SelectedItem.ToString()

    Try
        ' Determine if the file exists before loading.
        If System.IO.File.Exists(file) Then
            ' Open the file and use a TextReader to read the contents into the TextBox.
            Dim myFile As New System.IO.FileInfo(listBox1.SelectedItem.ToString())
            Dim myData As System.IO.TextReader = myFile.OpenText()

            textBox1.Text = myData.ReadToEnd()
            myData.Close()
        End If
        ' Exception is thrown by the OpenText method of the FileInfo class.
    Catch
        MessageBox.Show("The file you specified does not exist.")
        ' Exception is thrown by the ReadToEnd method of the TextReader class.
    Catch
     MessageBox.Show("There was a problem loading the file into the TextBox. Ensure that the file is a valid text file.")
    End Try
End Sub

Hinweise

Ein Doppelklick wird durch die Mauseinstellungen des Betriebssystems des Benutzers bestimmt.A double-click is determined by the mouse settings of the user's operating system. Der Benutzer kann den Zeitraum festlegen, innerhalb dessen der zweite Mausklick erfolgen muss, damit zwei aufeinander folgende Mausklicks als Doppelklick erkannt werden.The user can set the time between clicks of a mouse button that should be considered a double-click rather than two clicks. Das Click -Ereignis wird jedes Mal ausgelöst, wenn auf ein Steuerelement Doppel geklickt wird.The Click event is raised every time a control is double-clicked. Wenn Sie z. b. über Ereignishandler für das Click - DoubleClick Ereignis und das Form-Ereignis Click eines DoubleClick verfügen, werden die-und-Ereignisse ausgelöst, wenn auf das Formular Doppel geklickt wird und beide Methoden aufgerufen werden.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. Wenn auf ein Steuerelement Doppel geklickt wird und dieses Steuerelement das DoubleClick -Ereignis nicht unterstützt, wird das Click Ereignis möglicherweise zweimal ausgelöst.If a control is double-clicked and that control does not support the DoubleClick event, the Click event might be raised twice.

Sie müssen den- StandardDoubleClick Wert StandardClick und den ControlStyles - true Wert von auf festlegen, damit dieses Ereignis ausgelöst wird.You must set the StandardDoubleClick and StandardClick values of ControlStyles to true for this event to be raised. Diese Werte werden möglicherweise bereits auf true festgelegt, wenn Sie von vorhandenen Windows Forms-Steuerelementen erben.These values might already be set to true if you are inheriting from existing Windows Forms controls.

Hinweis

Die folgenden TabControl Ereignisse werden für die-Klasse nur ausgelöst, wenn mindestens eine MouseUp MouseHover TabControl.TabPages DoubleClick TabPage in der Auflistung vorhanden ist Click:, MouseDown,,, MouseEnter,, MouseLeave und .MouseMoveThe 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. Wenn in der Auflistung mindestens eine TabPage vorhanden ist und der Benutzer mit dem Header des Registerkarten-Steuer Elements interagiert (wo TabPage die TabControl Namen angezeigt werden), löst das entsprechende-Ereignis aus.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. Wenn sich die Benutzerinteraktion jedoch im Client Bereich der Registerkarte befindet, TabPage löst die das entsprechende-Ereignis aus.However, if the user interaction is within the client area of the tab page, the TabPage raises the appropriate event.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Hinweise für Vererber

Das Erben von einem Standard Windows Forms-Steuerelement und StandardClick das StandardDoubleClick Ändern der- true oder-Werte von ControlStyles in können zu unerwartetem Verhalten führen oder Click keinerlei Auswirkungen haben, wenn das Steuerelement oder DoubleClicknichtunterstützt.Ereignisse.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.

In der folgenden Tabelle sind Windows Forms Steuerelemente und dasClick Ereignis DoubleClick(oder) aufgeführt, das als Reaktion auf die angegebene Maus Aktion ausgelöst wird.The following table lists Windows Forms controls and which event (Click or DoubleClick) is raised in response to the mouse action specified.

SteuerelementControl Linker MausklickLeft Mouse Click Doppelklick mit der linken MaustasteLeft Mouse Double Click Mit der rechten MaustasteRight Mouse Click Doppelklick mit der rechten MaustasteRight Mouse Double Click Mittlere MaustasteMiddle Mouse Click Mittlere Maustaste DoppelklickMiddle Mouse Double Click XButton1 mit MausklickXButton1 Mouse Click XButton1 Maustaste doppelklickenXButton1 Mouse Double-Click XButton2 mit MausklickXButton2 Mouse Click XButton2 Maustaste doppelklickenXButton2 Mouse Double-Click
MonthCalendar,MonthCalendar, DateTimePicker,DateTimePicker, RichTextBox,RichTextBox, HScrollBar,HScrollBar, VScrollBar Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone
Button,Button, CheckBox,CheckBox, RadioButton KlickenClick Klicken Sie auf.Click, Click Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone
ListBox,ListBox, CheckedListBox,CheckedListBox, ComboBox KlickenClick Click, DoubleClickClick, DoubleClick Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone
TextBox,TextBox, DomainUpDown,DomainUpDown, NumericUpDown KlickenClick Click, DoubleClickClick, DoubleClick Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone
\* TreeView,\* TreeView, \* ListView\* ListView KlickenClick Click, DoubleClickClick, DoubleClick KlickenClick Click, DoubleClickClick, DoubleClick Keinenone Keinenone Keinenone Keinenone Keinenone Keinenone
ProgressBar,ProgressBar, TrackBar KlickenClick Klicken Sie auf.Click, Click KlickenClick Klicken Sie auf.Click, Click KlickenClick Klicken Sie auf.Click, Click KlickenClick Klicken Sie auf.Click, Click KlickenClick Klicken Sie auf.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 KlickenClick Click, DoubleClickClick, DoubleClick KlickenClick Click, DoubleClickClick, DoubleClick KlickenClick Click, DoubleClickClick, DoubleClick KlickenClick Click, DoubleClickClick, DoubleClick KlickenClick Click, DoubleClickClick, DoubleClick

*Der Mauszeiger muss sich über einem untergeordneten ObjektTreeNode befinden ListViewItem(oder).* The mouse pointer must be over a child object (TreeNode or ListViewItem).

* * TabControl Muss mindestens eine TabPage in TabPages der Auflistung enthalten.** The TabControl must have at least one TabPage in its TabPages collection.

Gilt für:

Siehe auch