Cette documentation est archivée et n’est pas conservée.

Control.DoubleClick, événement

Mise à jour : novembre 2007

Se produit à la suite d'un double-clic sur le contrôle.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public event EventHandler DoubleClick
/** @event */
public void add_DoubleClick (EventHandler value)
/** @event */
public void remove_DoubleClick (EventHandler value)

JScript ne prend pas en charge les événements.

Un double-clic est déterminé par les paramètres de souris du système d'exploitation de l'utilisateur. L'utilisateur peut définir le délai qui détermine si les clics effectués sur un bouton de souris sont considérés comme un double-clic ou comme deux clics. L'événement Click est déclenché à chaque double-clic sur un contrôle. Par exemple, si vous disposez de gestionnaires d'événements pour les événements Click et DoubleClick de Form, les événements Click et DoubleClick se déclenchent lorsqu'un double-clic se produit sur le formulaire et que les deux méthodes sont appelées. Si un double-clic se produit sur un contrôle et si ce dernier ne prend pas en charge l'événement DoubleClick, l'événement Click risque de se déclencher deux fois.

Les valeurs StandardDoubleClick et StandardClick de ControlStyles doivent avoir la valeur true pour permettre le déclenchement de cet événement. Ces valeurs peuvent avoir déjà la valeur true si vous héritez de contrôles Windows Forms existants.

Remarque :

Les événements suivants ne sont pas déclenchés pour la classe TabControl tant qu'il n'y a pas au moins un TabPage dans la collection TabControl.TabPages : Click, DoubleClick, MouseDown, MouseUp, MouseHover, MouseEnter, MouseLeave et MouseMove. S'il existe au moins un TabPage dans la collection et si l'utilisateur interagit avec l'en-tête du contrôle onglet (où les noms TabPage apparaissent), TabControl déclenche l'événement approprié. Cependant, si l'interaction de l'utilisateur se limite à la zone cliente de la page d'onglets, TabPage déclenche l'événement approprié.

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

Remarques à l'attention des héritiers :

L'héritage d'un contrôle Windows Forms standard et le changement des valeurs StandardClick ou StandardDoubleClick de ControlStyles en true peuvent aboutir à un comportement inattendu ou ne produire aucun effet si le contrôle ne prend pas en charge les événements Click ou DoubleClick.

Le tableau suivant répertorie les contrôles Windows Forms et détermine l'événement (Click ou DoubleClick) déclenché en réponse à l'action spécifique effectuée à l'aide de la souris.

Contrôle

Clic avec le bouton gauche de la souris

Double-clic avec le bouton gauche de la souris

Clic avec le bouton droit de la souris

Double-clic avec le bouton droit de la souris

Clic avec le bouton du milieu de la souris

Double-clic avec le bouton du milieu de la souris

Clic avec le XButton1 de la souris

Double-clic avec le XButton1 de la souris

Clic avec le XButton2 de la souris

Double-clic avec le XButton2 de la souris

MonthCalendar,

DateTimePicker,

RichTextBox,

HScrollBar,

VScrollBar

aucun

aucun

aucun

aucun

aucun

aucun

aucun

aucun

aucun

aucun

Button,

CheckBox,

RadioButton

Click

Click, Click

aucun

aucun

aucun

aucun

aucun

aucun

aucun

aucun

ListBox,

CheckedListBox,

ComboBox

Click

Click, DoubleClick

aucun

aucun

aucun

aucun

aucun

aucun

aucun

aucun

TextBox,

DomainUpDown,

NumericUpDown

Click

Click, DoubleClick

aucun

aucun

aucun

aucun

aucun

aucun

aucun

aucun

* TreeView,

* ListView

Click

Click, DoubleClick

Click

Click, DoubleClick

aucun

aucun

aucun

aucun

aucun

aucun

ProgressBar,

TrackBar

Click

Click, Click

Click

Click, Click

Click

Click, Click

Click

Click, Click

Click

Click, Click

Form,

DataGrid,

Label,

LinkLabel,

Panel,

GroupBox,

PictureBox,

Splitter,

StatusBar,

ToolBar,

TabPage,

** TabControl

Click

Click, DoubleClick

Click

Click, DoubleClick

Click

Click, DoubleClick

Click

Click, DoubleClick

Click

Click, DoubleClick

* Le pointeur de la souris doit se trouver au-dessus d'un objet enfant (TreeNode ou ListViewItem).

** TabControl doit posséder au moins un TabPage dans sa collection TabPages.

L'exemple de code suivant utilise l'événement DoubleClick de ListBox pour charger des fichiers texte répertoriés dans ListBox dans un contrôle 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 = 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 void listBox1_DoubleClick(Object sender, System.EventArgs e)
{
    // Get the name of the file to open from the ListBox.
    String file = listBox1.get_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.
                get_SelectedItem().ToString());
            System.IO.TextReader myData = myFile.OpenText();
            textBox1.set_Text(myData.ReadToEnd());
            myData.Close();
        }
    }
    // Exception is thrown by the OpenText method of the FileInfo class.
    catch (System.IO.FileNotFoundException exp) {
        MessageBox.Show("The file you specified does not exist.");
    }
    // Exception is thrown by the ReadToEnd method of the TextReader class.
    catch (System.IO.IOException exp) {
        MessageBox.Show("There was a problem loading the file into the "
            + "TextBox. Ensure that the file is a valid text file.");
    }
} //listBox1_DoubleClick


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0
Afficher: