Control.DoubleClick Событие

Определение

Происходит при двойном щелчке элемента управления.

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

Тип события

Примеры

В следующем примере кода используется DoubleClick событие загрузки текстовых ListBox файлов, перечисленных в ListBox элементе TextBox управления.

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

Комментарии

Двойной щелчок определяется параметрами мыши операционной системы пользователя. Пользователь может задать время между щелчками кнопки мыши, которая должна считаться двойной щелчок, а не два щелчка. Событие Click возникает каждый раз, когда элемент управления дважды щелкается. Например, если у вас есть обработчики событий для Click событий и DoubleClick событий, FormClick возникают и DoubleClick события, когда форма дважды щелкается, и вызываются оба метода. Если элемент управления дважды щелкается, и этот элемент управления не поддерживает DoubleClick событие, Click событие может вызываться дважды.

Необходимо задать StandardDoubleClick значение и StandardClick значения ControlStylestrue для этого события. Эти значения уже могут иметь значение true, если вы наследуете существующие элементы управления Windows Forms.

Note

Следующие события не вызываются для TabControl класса, если в коллекции нет хотя бы одного TabPageTabControl.TabPages из них: Click, , DoubleClick, MouseDownMouseUpMouseHover, и . MouseEnterMouseLeaveMouseMove Если в коллекции есть хотя бы один TabPage , и пользователь взаимодействует с заголовком элемента управления вкладки (где TabPage отображаются имена), вызывает TabControl соответствующее событие. Однако если взаимодействие пользователя находится в клиентской области страницы вкладок, TabPage вызывает соответствующее событие.

Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".

Примечания для тех, кто наследует этот метод

Наследование от стандартного элемента управления Windows Forms и изменение значения StandardClick или StandardDoubleClick значений ControlStyles на true может привести к неожиданному поведению или не оказывает никакого влияния, если элемент управления не поддерживает события Click или DoubleClick.

В следующей таблице перечислены элементы управления Windows Forms и события (Click или DoubleClick) возникают в ответ на указанное действие мыши.

Контроль Щелкните левую кнопку мыши Дважды щелкните левую мышь Щелкните правой кнопкой мыши Дважды щелкните правой кнопкой мыши Щелчок по центру мыши Двойной щелчок по средней мыши XButton1 Mouse Click Double-Click мыши XButton1 XButton2 Mouse Click Double-Click мыши XButton2
Microsoft.Network/virtualNetworks/write,

DateTimePicker,

RichTextBox,

HScrollBar,

VScrollBar

нет

Нет Нет Нет Нет Нет Нет Нет Нет Нет
Microsoft.Network/virtualNetworks/write,

CheckBox,

RadioButton

Команда

Щелкните, щелкните Нет Нет Нет Нет Нет Нет Нет Нет
Microsoft.Network/virtualNetworks/write,

CheckedListBox,

ComboBox

Команда

Щелкните, DoubleClick Нет Нет Нет Нет Нет Нет Нет Нет
Microsoft.Network/virtualNetworks/write,

DomainUpDown,

NumericUpDown

Команда

Щелкните, DoubleClick Нет Нет Нет Нет Нет Нет Нет Нет
* TreeView,

* ListView

Команда

Щелкните, DoubleClick Щелкните . Щелкните, DoubleClick Нет Нет Нет Нет Нет Нет
Microsoft.Network/virtualNetworks/write,

TrackBar

Команда

Щелкните, щелкните Щелкните . Щелкните, щелкните Щелкните . Щелкните, щелкните Щелкните . Щелкните, щелкните Щелкните . Щелкните, щелкните
Microsoft.Network/virtualNetworks/write,

DataGrid,

Label,

LinkLabel,

Panel,

GroupBox,

PictureBox,

Splitter,

StatusBar,

ToolBar,

TabPage,

** TabControl

Команда

Щелкните, DoubleClick Щелкните . Щелкните, DoubleClick Щелкните . Щелкните, DoubleClick Щелкните . Щелкните, DoubleClick Щелкните . Щелкните, DoubleClick

* Указатель мыши должен быть над дочерним объектом (TreeNode или ListViewItem).

** Должен TabControl иметь по крайней мере один TabPage в коллекции TabPages .

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

См. также раздел