Créer une nouvelle méthode de gestionnaire d’événements

Lorsque vous travaillez dans un projet Windows Presentation Foundation (WPF) ou Microsoft Silverlight, Microsoft Expression Blend peut générer du code pour les méthodes de gestionnaire d’événements vides, afin d’en faciliter la prise en main.

Expression Blend ouvre votre fichier code-behind puis le colle dans la méthode de gestionnaire d'événements vide.

Pour plus d'informations sur les gestionnaires d'événements dans les codes ou la création d'une interactivité dans votre application Expression Blend sans utiliser de code, voir la rubriqueÉcriture de code de gestion des événements.

Pour créer une nouvelle méthode de gestionnaire d’événements

1. Ouvrez votre projet dans Expression Blend.

2. Ouvrez votre document (par exemple, MainWindow.xaml) en double-cliquant dessus dans le panneau Projets.

   Votre document sera ouvert pour la modification. Assurez-vous que vous êtes en mode Création en cliquant sur l’onglet Création à droite de la planche graphique.

3. Dans le panneau Objets et chronologie, sélectionnez l’élément à connecter à une méthode de gestionnaire d’événements existante. Par exemple, si vous souhaitez qu'un élément rectangle se déplace lorsque vous cliquez sur un bouton, sélectionnez l'élément bouton.

   L'arrière-plan derrière le nom de l'élément est mis en surbrillance, pour indiquer que l'élément est sélectionné.

4. Dans le panneau Propriétés, cliquez sur Événements.

   Une liste alphabétique de tous les événements disponibles s’affiche pour l’élément sélectionné.

   Attention :
   Aucun événement n'apparaîtra si plusieurs objets sont sélectionnés en même temps dans le panneau Objets et chronologie (par exemple, en maintenant la touche Ctrl enfoncée pour sélectionner plusieurs objets).

   Conseil :
   Pour afficher une courte description d’un événement, placez le pointeur de la souris sur le nom de l’événement. Une info-bulle affiche alors une description de l’événement.

5. Recherchez l’événement auquel ajouter la logique de programmation. Par exemple, dans l’exemple du rectangle et du bouton, recherchez l’événement MouseDown.

6. Vous pouvez générer la méthode de gestionnaire d’événements vide de deux manières :

   • Double-cliquez dans la zone de texte en regard du nom de l’événement. Expression Blend génère un nom par défaut pour votre méthode de gestionnaire d’événements et l’inscrit dans la zone de texte, puis génère le code pour la méthode vide.

   • Tapez un nom dans la zone de texte en regard du nom de l’événement, puis appuyez sur Entrée ou cliquez en dehors de la zone de texte pour déplacer le focus hors de la zone de texte. Le nom des méthodes de gestionnaire d’événements doit commencer par une lettre. Si le nom de la méthode n’existe pas déjà dans le fichier code-behind, Expression Blend génère le code pour la méthode vide et utilise le nom que vous avez tapé.

   Expression Blend ouvre votre fichier code-behind puis le colle dans la méthode de gestionnaire d'événements vide.

     public partial class Window1
     {
         public Window1()
         {
             this.InitializeComponent();
   
             // Insert code required on object creation below this point.
         }
   
         private void Button_MouseDown(object sender, RoutedEventArgs e)      {      }
     }
   

7. Votre fichier code-behind étant ouvert et la méthode de gestionnaire d’événements étant collée, vous pouvez commencer à ajouter du code à votre méthode. Pour les besoins de cette procédure, vous pouvez ajouter la ligne de code rouge suivante afin de faire apparaître une zone de message lorsque vous cliquez sur le bouton :

     private void Button_MouseDown(object sender, RoutedEventArgs e)
     {
         MessageBox.Show("Hello!");
     }
   

   Pour obtenir des exemples de méthodes de gestionnaires d’événements dans le fichier code-behind, voir les exemples disponibles dans l’Écran d’accueil (cliquez sur Écran d’accueil dans le menu ? (Aide)).

   Remarque :

   Expression Blend indique une erreur de build si vous faites référence à une méthode de gestionnaire d’événements dans le panneau Événements qui n'existe pas dans le fichier code-behind. Si vous obtenez ce type d’erreur, vous pouvez déterminer si le nom de la méthode de gestionnaire d’événements contient une erreur ou vous pouvez double-cliquer dans la zone de texte de l’événement pour créer une nouvelle méthode de gestionnaire d’événements vide. Lorsque vous supprimez ou modifiez le nom d’une méthode de gestionnaire d’événements dans une zone de texte du panneau Événements, Expression Blend ne supprime pas la méthode d’origine du fichier code-behind. En effet, il est possible que l’événement soit encore utilisé ailleurs. Vous ne recevez pas de message d’erreur de build s’il existe une méthode de gestionnaire d’événements définie dans votre fichier code-behind à laquelle votre fichier XAML ne fait pas référence.

   Remarque :
   Pour faire référence à un élément de votre fichier .xaml à partir d’un fichier code-behind, vous devez nommer l’élément dans le fichier .xaml. Par défaut, les éléments créés dans Expression Blend ne sont pas nommés. Vous pouvez nommer un élément dans le panneau Objets et chronologie en cliquant avec le bouton droit sur l’élément, puis en cliquant sur Renommer.