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

Определение

Происходит при двойном щелчке элемента управления.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 

Примеры

В следующем примере кода используется DoubleClick событие ListBox для загрузки текстовых файлов, перечисленных в 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. Пользователь может задать время между нажатиями кнопки мыши, которые будут считаться двойным щелчком, а не двумя отдельными щелчками.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. Например, если у вас есть обработчики событий для Click и DoubleClick события Form, Click и DoubleClick событий при двойном щелчке формы и вызове обоих методов.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.

Необходимо задать StandardDoubleClick и StandardClick значения ControlStyles для true для возникновения этого события.You must set the StandardDoubleClick and StandardClick values of ControlStyles to true for this event to be raised. Эти значения могут быть уже задано значение true Если вы наследуете от существующих элементов управления Windows Forms.These values might already be set to true if you are inheriting from existing Windows Forms controls.

Примечание

Следующие события не вызываются для TabControl класса, если имеется по крайней мере один TabPage в TabControl.TabPages коллекции: Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnter, MouseLeave и MouseMove.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 в коллекции, и пользователь взаимодействует с заголовка элемента управления tab (где 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 и замена StandardClick или StandardDoubleClick значения ControlStyles для 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 Мыши XButton1XButton1 Mouse Double-Click Щелчок мыши XButton2XButton2 Mouse Click Мыши xbutton2XButton2 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 Щелчок, двойной щелчокClick, DoubleClick Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
TextBox,TextBox, DomainUpDown,DomainUpDown, NumericUpDown Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone Нетnone
\* TreeView,\* TreeView, \* ListView\* ListView Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчок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 Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick Нажмите кнопкуClick Щелчок, двойной щелчокClick, DoubleClick

* Указатель мыши должен быть на дочернем объекте (TreeNode или ListViewItem).* The mouse pointer must be over a child object (TreeNode or ListViewItem).

** TabControl Должен иметь по крайней мере TabPage в его TabPages коллекции.** The TabControl must have at least one TabPage in its TabPages collection.

Применяется к

Дополнительно