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,
| нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Microsoft.Network/virtualNetworks/write,
| Команда | Щелкните, щелкните | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Microsoft.Network/virtualNetworks/write,
| Команда | Щелкните, DoubleClick | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Microsoft.Network/virtualNetworks/write,
| Команда | Щелкните, DoubleClick | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
|
*
TreeView, * ListView | Команда | Щелкните, DoubleClick | Щелкните . | Щелкните, DoubleClick | Нет | Нет | Нет | Нет | Нет | Нет |
Microsoft.Network/virtualNetworks/write, | Команда | Щелкните, щелкните | Щелкните . | Щелкните, щелкните | Щелкните . | Щелкните, щелкните | Щелкните . | Щелкните, щелкните | Щелкните . | Щелкните, щелкните |
Microsoft.Network/virtualNetworks/write,
** TabControl | Команда | Щелкните, DoubleClick | Щелкните . | Щелкните, DoubleClick | Щелкните . | Щелкните, DoubleClick | Щелкните . | Щелкните, DoubleClick | Щелкните . | Щелкните, DoubleClick |
* Указатель мыши должен быть над дочерним объектом (TreeNode или ListViewItem).
** Должен TabControl иметь по крайней мере один TabPage в коллекции TabPages .