Control.DoubleClick 이벤트

정의

컨트롤을 두 번 클릭하면 발생합니다.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 

예제

다음 코드 예제에서는 ListBoxDoubleClick 이벤트를 사용 하 여 ListBox에 나열 된 텍스트 파일을 TextBox 컨트롤로 로드 합니다.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

설명

두 번 클릭은 운영 체제의 마우스 설정에 따라 결정 됩니다.A double-click is determined by the mouse settings of the user's operating system. 천천히 두 번 클릭하는 것이 아닌 두 번 클릭(double-click)으로 간주될 수 있도록 마우스 단추 클릭 간격을 설정할 수 있습니다.The user can set the time between clicks of a mouse button that should be considered a double-click rather than two clicks. Click 이벤트는 컨트롤을 두 번 클릭할 때마다 발생 합니다.The Click event is raised every time a control is double-clicked. 예를 들어 FormClickDoubleClick 이벤트에 대 한 이벤트 처리기가 있는 경우 폼을 두 번 클릭 하 고 두 메서드를 모두 호출 하면 ClickDoubleClick 이벤트가 발생 합니다.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. 컨트롤을 두 번 클릭 하 고 해당 컨트롤이 DoubleClick 이벤트를 지원 하지 않는 경우 Click 이벤트가 두 번 발생할 수 있습니다.If a control is double-clicked and that control does not support the DoubleClick event, the Click event might be raised twice.

이 이벤트를 발생 시키려면 ControlStylesStandardDoubleClickStandardClick 값을 true로 설정 해야 합니다.You must set the StandardDoubleClick and StandardClick values of ControlStyles to true for this event to be raised. 기존 Windows Forms 컨트롤에서 상속 하는 경우 이러한 값은 true으로 이미 설정 되어 있을 수 있습니다.These values might already be set to true if you are inheriting from existing Windows Forms controls.

참고

다음 이벤트는 TabControl.TabPages 컬렉션에 TabPage이 하나 이상 있는 경우를 제외 하 고 TabControl 클래스에 대해 발생 하지 않습니다. Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnter, MouseLeave, 0입니다.The 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. 컬렉션에 하나 이상의 TabPage 있고 사용자가 탭 컨트롤의 헤더 (TabPage 이름이 표시 됨)와 상호 작용 하는 경우 TabControl는 적절 한 이벤트를 발생 시킵니다.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. 그러나 사용자 조작이 탭 페이지의 클라이언트 영역 내에 있는 경우 TabPage은 적절 한 이벤트를 발생 시킵니다.However, if the user interaction is within the client area of the tab page, the TabPage raises the appropriate event.

이벤트 처리에 대한 자세한 내용은 이벤트 처리 및 발생 을 참조하십시오.For more information about handling events, see Handling and Raising Events.

상속자 참고

표준 Windows Forms 컨트롤에서 상속 하 고 ControlStylesStandardClick 또는 StandardDoubleClick 값을 true로 변경 하면 예기치 않은 동작이 발생할 수 있습니다. 컨트롤이 Click 또는 DoubleClick 이벤트를 지원 하지 않을 경우에는 전혀 영향을 주지 않습니다.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.

다음 표에서는 Windows Forms 컨트롤과 지정 된 마우스 동작에 대 한 응답으로 발생 하는 이벤트 (Click 또는 DoubleClick)를 보여 줍니다.The following table lists Windows Forms controls and which event (Click or DoubleClick) is raised in response to the mouse action specified.

컨트롤Control 마우스 왼쪽 단추 클릭Left Mouse Click 마우스 왼쪽 단추 두 번 클릭Left Mouse Double Click 마우스 오른쪽 단추 클릭Right Mouse Click 마우스 오른쪽 단추 두 번 클릭Right Mouse Double Click 마우스 가운데 단추 클릭Middle Mouse Click 마우스 가운데 단추 두 번 클릭Middle Mouse Double Click 마우스 클릭 XButton1XButton1 Mouse Click XButton1 마우스 두 번 클릭XButton1 Mouse Double-Click 마우스 클릭 있는XButton2 Mouse Click 있는 마우스 두 번 클릭XButton2 Mouse Double-Click
MonthCalendar,MonthCalendar, DateTimePicker,DateTimePicker, RichTextBox,RichTextBox, HScrollBar,HScrollBar, VScrollBar 없음none 없음none 없음none 없음none 없음none 없음none 없음none 없음none 없음none 없음none
Button,Button, CheckBox,CheckBox, RadioButton 클릭 대상Click 을 클릭 하 고Click, Click 없음none 없음none 없음none 없음none 없음none 없음none 없음none 없음none
ListBox,ListBox, CheckedListBox,CheckedListBox, ComboBox 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 없음none 없음none 없음none 없음none 없음none 없음none 없음none 없음none
TextBox,TextBox, DomainUpDown,DomainUpDown, NumericUpDown 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 없음none 없음none 없음none 없음none 없음none 없음none 없음none 없음none
\* TreeView\* TreeView, \* ListView\* ListView 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 없음none 없음none 없음none 없음none 없음none 없음none
ProgressBar,ProgressBar, TrackBar 클릭 대상Click 을 클릭 하 고Click, Click 클릭 대상Click 을 클릭 하 고Click, Click 클릭 대상Click 을 클릭 하 고Click, Click 클릭 대상Click 을 클릭 하 고Click, Click 클릭 대상Click 을 클릭 하 고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 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick 클릭 대상Click DoubleClick을 클릭 합니다.Click, DoubleClick

* 마우스 포인터는 자식 개체 (TreeNode 또는 ListViewItem) 위에 있어야 합니다.* The mouse pointer must be over a child object (TreeNode or ListViewItem).

* * TabControlTabPages 컬렉션에 TabPage가 하나 이상 있어야 합니다.** The TabControl must have at least one TabPage in its TabPages collection.

적용 대상

추가 정보