Control.DoubleClick Esemény

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.cs

Akkor fordul elő, ha a vezérlőre duplán kattint.

public:
 event EventHandler ^ DoubleClick;

public event EventHandler? DoubleClick;

member this.DoubleClick : EventHandler 

Public Custom Event DoubleClick As EventHandler 

Eseménytípus

EventHandler

Példák

Az alábbi példakód egy DoubleClickListBox esemény eseményével tölti be a ListBox vezérlőben TextBox felsorolt szövegfájlokat.

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

Megjegyzések

A dupla kattintást a felhasználó operációs rendszerének egérbeállításai határozzák meg. A felhasználó beállíthatja az egérgombok kattintásai közötti időt, amelyet két kattintás helyett dupla kattintásnak kell tekinteni. Az Click esemény minden alkalommal létre lesz hozva, amikor a vezérlőre duplán kattint. Ha például egy adott esemény eseménykezelőivel ClickDoubleClick rendelkezik, a rendszer az Form űrlap duplán kattintásával és Click mindkét metódus meghívásával DoubleClickelőhozza az eseményeket. Ha egy vezérlőre duplán kattint, és ez a vezérlő nem támogatja az DoubleClick eseményt, előfordulhat, hogy az Click esemény kétszer lesz előállítva.

Ehhez az eseményhez be kell állítania StandardDoubleClickStandardClick az ControlStylestrue esemény értékét és értékeit. Előfordulhat, hogy ezek az értékek már true értékre vannak állítva, ha meglévő Windows Forms vezérlőktől örököl.

Note

A következő események csak akkor kerülnek elő az TabControl osztály számára, ha legalább egy TabPage van a TabControl.TabPages gyűjteményben: Click, , DoubleClick, MouseDownMouseUp, MouseHover, MouseEnterMouseLeave és MouseMove. Ha legalább egy TabPage van a gyűjteményben, és a felhasználó a tabulátor fejlécével lép kapcsolatba (ahol a TabPage nevek megjelennek), a TabControl megfelelő esemény keletkezik. Ha azonban a felhasználói interakció a lap ügyfélterületén belül van, a TabPage megfelelő eseményt aktiválja.

Az események kezelésével kapcsolatos további információkért lásd : Események kezelése és emelése.

Megjegyzések az öröklőkhöz

A standard Windows Forms vezérlőelemtől való öröklődés és a StandardClick vagy StandardDoubleClick értékek ControlStyles értékének true módosítása váratlan viselkedést okozhat, vagy egyáltalán nincs hatása, ha a vezérlő nem támogatja a Click vagy DoubleClick eseményeket.

Az alábbi táblázat felsorolja Windows Forms vezérlőket, és azt, hogy melyik esemény (Click vagy DoubleClick) kerül sor a megadott egérműveletre válaszul.

Vezérlő	Bal egérkattintás	Bal egér dupla kattintással	Kattintson a jobb egérgombbal	Kattintson duplán a jobb egérgombbal	Közép egérkattintás	Középső egér dupla kattintással	XButton1 egérkattintás	XButton1 egér Double-Click	XButton2 egérkattintás	XButton2 egér Double-Click
MonthCalendar, DateTimePicker, RichTextBox, HScrollBar, VScrollBar	Nincs	nincs	nincs	nincs	nincs	nincs	nincs	nincs	nincs	nincs
Button, CheckBox, RadioButton	Kattintás	Kattintson, kattintson a	nincs	nincs	nincs	nincs	nincs	nincs	nincs	nincs
ListBox, CheckedListBox, ComboBox	Kattintás	Kattintson a DoubleClick parancsra	nincs	nincs	nincs	nincs	nincs	nincs	nincs	nincs
TextBox, DomainUpDown, NumericUpDown	Kattintás	Kattintson a DoubleClick parancsra	nincs	nincs	nincs	nincs	nincs	nincs	nincs	nincs
* TreeView, * ListView	Kattintás	Kattintson a DoubleClick parancsra	Kattintson a	Kattintson a DoubleClick parancsra	nincs	nincs	nincs	nincs	nincs	nincs
ProgressBar, TrackBar	Kattintás	Kattintson, kattintson a	Kattintson a	Kattintson, kattintson a	Kattintson a	Kattintson, kattintson a	Kattintson a	Kattintson, kattintson a	Kattintson a	Kattintson, kattintson a
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	Kattintás	Kattintson a DoubleClick parancsra	Kattintson a	Kattintson a DoubleClick parancsra	Kattintson a	Kattintson a DoubleClick parancsra	Kattintson a	Kattintson a DoubleClick parancsra	Kattintson a	Kattintson a DoubleClick parancsra

* Az egérmutatónak gyermekobjektum (TreeNode vagy ListViewItem) fölött kell lennie.

** A TabControl gyűjteményben legalább egynek TabPage rendelkeznie TabPages kell.

Lásd még

• OnDoubleClick(EventArgs)
• StandardClick
• StandardDoubleClick
• Click
• MouseClick
• MouseDoubleClick