Control.DoubleClick Evento

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Se produce cuando se hace doble clic en el control.

public:
 event EventHandler ^ DoubleClick;

public event EventHandler DoubleClick;

public event EventHandler? DoubleClick;

member this.DoubleClick : EventHandler

Public Custom Event DoubleClick As EventHandler

Tipo de evento

EventHandler

Ejemplos

En el ejemplo de código siguiente se usa el DoubleClick evento de para ListBox cargar archivos de texto enumerados en ListBox un 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

Comentarios

Un doble clic viene determinado por la configuración del mouse del sistema operativo del usuario. El usuario puede establecer el tiempo entre los clics de un botón del mouse que debe considerarse como un doble clic y no como dos clics. El Click evento se genera cada vez que se hace doble clic en un control. Por ejemplo, si tiene controladores de eventos para los Click eventos y de , Formlos Click eventos y DoubleClick DoubleClick se generan cuando se hace doble clic en el formulario y se llama a ambos métodos. Si se hace doble clic en un control y ese control no es compatible con el DoubleClick evento, el Click evento puede generarse dos veces.

Debe establecer los StandardDoubleClick valores y StandardClick de ControlStyles en true para que se genere este evento. Es posible que estos valores ya estén establecidos true en si se hereda de los controles de Windows Forms existentes.

Nota

Los siguientes eventos no se generan para la TabControl clase a menos que haya al menos uno TabPage en la TabControl.TabPages colección: Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEntery MouseLeave MouseMove. Si hay al menos una TabPage en la colección y el usuario interactúa con el encabezado del control de pestaña (donde aparecen los TabPage nombres), TabControl genera el evento adecuado. Sin embargo, si la interacción del usuario está dentro del área cliente de la página de pestaña, TabPage genera el evento adecuado.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Notas a los desarrolladores de herederos

Heredar de un control estándar Windows Forms y cambiar los StandardClick valores o StandardDoubleClick de ControlStyles a true puede provocar un comportamiento inesperado o no tener ningún efecto si el control no admite los Click eventos o DoubleClick .

En la tabla siguiente se enumeran Windows Forms controles y qué evento (Click o DoubleClick) se genera en respuesta a la acción del mouse especificada.

Control	Clic con el ratón izquierdo	Clic doble del mouse izquierdo	Haga clic con el botón derecho del mouse	Clic doble del mouse derecho	Clic central del mouse	Clic doble del mouse central	Clic del mouse XButton1	Double-Click del mouse XButton1	Clic del mouse XButton2	Double-Click del mouse XButton2
MonthCalendar, DateTimePicker, RichTextBox, HScrollBar, VScrollBar	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno
Button, CheckBox, RadioButton	Haga clic en	Haga clic, haga clic en	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno
ListBox, CheckedListBox, ComboBox	Haga clic en	Haga clic en DoubleClick.	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno
TextBox, DomainUpDown, NumericUpDown	Haga clic en	Haga clic en DoubleClick.	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno
* TreeView, * ListView	Haga clic en	Haga clic en DoubleClick.	Haga clic en	Haga clic en DoubleClick.	ninguno	ninguno	ninguno	ninguno	ninguno	ninguno
ProgressBar, TrackBar	Haga clic en	Haga clic, haga clic en	Haga clic en	Haga clic, haga clic en	Haga clic en	Haga clic, haga clic en	Haga clic en	Haga clic, haga clic en	Haga clic en	Haga clic, haga clic en
Form, DataGrid, Label, LinkLabel, Panel, GroupBox, PictureBox, Splitter, StatusBar, ToolBar, TabPage, ** TabControl	Haga clic en	Haga clic en DoubleClick.	Haga clic en	Haga clic en DoubleClick.	Haga clic en	Haga clic en DoubleClick.	Haga clic en	Haga clic en DoubleClick.	Haga clic en	Haga clic en DoubleClick.

* El puntero del mouse debe estar sobre un objeto secundario (TreeNode o ListViewItem).

** El TabControl debe tener al menos uno TabPage en su TabPages colección.

Se aplica a

Control.DoubleClick Evento

Definición

Tipo de evento

Ejemplos

Comentarios

Notas a los desarrolladores de herederos

Se aplica a

Consulte también

Comentarios

Recursos adicionales