Comment : créer un gestionnaire d'événements simple

Article
08/21/2008

Mise à jour : novembre 2007

Les étapes pour créer un gestionnaire d'événements dans le Concepteur Windows Presentation Foundation (WPF) pour Visual Studio diffèrent légèrement de celles du Concepteur Windows Forms. À partir de Visual Studio 2008SP1, vous pouvez utiliser le bouton Événements dans la fenêtre Propriétés. La procédure suivante décrit comment créer des gestionnaires d'événements simples dans le Concepteur WPF.

Pour créer un gestionnaire d'événements par défaut

En mode Design, double-cliquez sur le contrôle pour lequel vous souhaitez créer un gestionnaire d'événements.

Le gestionnaire d'événements par défaut du contrôle est créé. Le fichier code-behind s'ouvre et le curseur est positionné dans le gestionnaire d'événements par défaut.

Pour créer un gestionnaire d'événements en XAML

En mode XAML, localisez l'élément pour lequel vous souhaitez créer un gestionnaire d'événements. Cette procédure utilise le contrôle Button.
Dans la balise de début de l'élément, commencez par taper le nom de l'événement que vous souhaitez gérer, par exemple l'événement Click ou MouseEnter.

Lorsque vous commencez à taper le nom de l'événement, une liste IntelliSense apparaît avec les événements disponibles, comme indiqué dans l'illustration suivante.

Dans la valeur d'attribut, tapez le nom du gestionnaire d'événements. Dans la liste IntelliSense qui s'affiche, vous pouvez double-cliquer sur <Nouveau gestionnaire d'événements> pour utiliser le nom de gestionnaire d'événements par défaut.

Remarque :
Si vous sélectionnez simplement <Nouveau gestionnaire d'événements> (sans double-cliquer), une info-bulle apparaît pour fournir des informations supplémentaires sur la méthode qui sera créée.

Le XAML suivant spécifie un gestionnaire d'événements Click et un gestionnaire d'événements MouseEnter pour un contrôle Button.

<Window x:Class="WPFApplication.Window1"
xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
Title="Window1" Height="300" Width="300">
    <Grid>
        <Button Height="23" HorizontalAlignment="Left"
        Margin="33,38,0,0" Name="Button1" VerticalAlignment="Top" 
        Width="75" 
        Click="button1_Click" MouseEnter="button1_MouseEnter">
        Button</Button>
    </Grid>
</Window>

En mode XAML, cliquez avec le bouton droit sur l'événement ou sur le nom du gestionnaire d'événements, puis sélectionnez l'option Naviguer vers le gestionnaire d'événements, comme indiqué dans l'illustration suivante.

Le fichier code-behind s'ouvre et le curseur est positionné dans le gestionnaire d'événements sélectionné. Le code ci-dessous présente les exemples de gestionnaires d'événements.
```
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs)

End Sub

Private Sub Button1_MouseEnter(ByVal sender As System.Object, ByVal e As System.Windows.Input.MouseEventArgs)

End Sub
```
```
private void button1_Click(object sender, RoutedEventArgs e)
{

}

private void button1_MouseEnter(object sender, MouseEventArgs e)
{

}
```

Pour créer un gestionnaire d'événements en utilisant les listes déroulantes de l'éditeur de code (Visual Basic uniquement)

Dans l'éditeur de code, ouvrez la liste déroulante Nom de la classe.
Sélectionnez le contrôle ou le type pour lequel vous voulez créer un gestionnaire d'événements.
Ouvrez la liste déroulante Nom de la méthode.
Sélectionnez l'événement pour lequel vous voulez créer un gestionnaire d'événements.

Un gestionnaire d'événements est créé et le curseur y est positionné.

Pour créer un gestionnaire d'événements en utilisant le bouton Événements

En mode Design, sélectionnez le contrôle pour lequel vous souhaitez créer un gestionnaire d'événements.
Dans la partie supérieure de la fenêtre Propriétés, cliquez sur le bouton Événements.

Les événements pour le contrôle sont répertoriés et l'événement par défaut est sélectionné.

Remarque :

Si vous ne voyez pas le bouton Événements, vérifiez que vous utilisez Visual Studio 2008 SP1 ou une version ultérieure.
Sélectionnez un événement et placez le curseur dans la colonne de valeur.
Tapez le nom du gestionnaire d'événements ou laissez la zone vide pour utiliser le nom par défaut.
Pour créer le gestionnaire d'événements, appuyez sur ENTRÉE ou double-cliquez sur la colonne de valeur.

Le gestionnaire d'événements du contrôle est créé. Le fichier code-behind s'ouvre et le curseur est positionné dans le gestionnaire d'événements. Pour les projets Visual C#, un attribut qui spécifie le gestionnaire d'événements est ajouté au fichier XAML. Pour les projets Visual Basic, le fichier XAML n'est pas modifié.