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

  • Article

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Les étapes pour créer un gestionnaire d'événements dans le Concepteur WPF pour Visual Studio diffèrent légèrement de celles du Concepteur Windows Forms. La procédure suivante décrit comment créer des gestionnaires d'événements simples dans le WPF Designer.

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

  1. 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.

  2. 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.

    Liste IntelliSense répertoriant les événements disponibles

  3. 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.

    Notes

    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.MainWindow"
xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
Title="MainWindow" 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>

  4. 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.

    Option Naviguer vers le gestionnaire d'événements

    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)

  1. Dans l'éditeur de code, ouvrez la liste déroulante Nom de la classe.

  2. Sélectionnez le contrôle ou le type pour lequel vous voulez créer un gestionnaire d'événements.

  3. Ouvrez la liste déroulante Nom de la méthode.

  4. 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

  1. En mode Design, sélectionnez le contrôle pour lequel vous souhaitez créer un gestionnaire d'événements.

  2. En haut 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é.

  3. Sélectionnez un événement et placez le curseur dans la colonne de valeur.

  4. Tapez le nom du gestionnaire d'événements ou laissez la zone vide pour utiliser le nom par défaut.

  5. 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é.

Voir aussi

Tâches

Comment : utiliser les événements attachés

Concepts

Vue d'ensemble du langage XAML (WPF)

Vue d'ensemble des événements routés

Code-behind et XAML dans WPF