Se connecter à une méthode de gestionnaire d’événements existante

Microsoft Expression Blend a été conçu dans un esprit de développement en équipe. Les équipes logicielles sont souvent constituées de designers qui conçoivent l’interface utilisateur et de programmeurs qui écrivent le code exécuté derrière l’interface utilisateur. Si vous êtes designer, il se peut que vous receviez un fichier code-behind modifié de la part d’un développeur qui a ajouté diverses méthodes de gestionnaire d’événements pour vous y connecter depuis l’interface utilisateur. Cette opération est possible dans Expression Blend.

Remarque :
Pour plus d’informations sur la gestion des événements Microsoft Silverlight 1.0 dans les fichiers code-behind, voir Vue d’ensemble de Silverlight 1.0 et Créer un bouton qui contrôle une table de montage séquentiel dans une application Silverlight. Voir également Silverlight scripting and mouse events (en anglais).

Pour plus d’informations sur les gestionnaires d’événements dans le code, voir Gestion des événements et interactivité utilisateur dans ce Guide de l’utilisateur. Pour plus d’informations sur la création d’interactivité dans votre application Expression Blend sans utilisation de code, voir Déclencheurs et interactivité avec l’utilisateur dans ce Guide de l’utilisateur.

Pour connecter une méthode de gestionnaire d’événements existante contenue dans un fichier code-behind

1. Vérifiez que vous disposez du fichier code-behind le plus récent qui contient les méthodes de gestionnaire d’événements. Pour ce faire, utilisez l’Explorateur Windows pour copier le fichier dans le dossier de votre projet, ou copiez l’intégralité du projet.

   Attention :
   Le fichier code-behind doit correspondre au fichier XAML (Extensible Application Markup Language) auquel connecter les gestionnaires d’événements. Par exemple, le fichier XAML Window1.xaml correspond au fichier code-behind Window1.xaml.cs si le nom x:Class du fichier XAML correspond à l’espace de noms et au nom de classe du fichier code-behind.

   Par exemple, dans le fichier XAML :

     x:Class="myProject.Window1"
   

   Dans le fichier code-behind :

     namespace myProject
     { 
         public partial class Window1
   

2. Ouvrez votre projet dans Expression Blend.

3. Ouvrez votre document (par exemple Window1.xaml) en double-cliquant dessus sous Fichiers dans le panneau Projet. Votre document s’ouvre pour modification. Assurez-vous que vous êtes en mode Création en cliquant sur l’onglet Création à droite de la planche graphique.

4. Sous Objets et chronologie dans le panneau Interaction, sélectionnez l’objet à connecter à une méthode de gestionnaire d’événements existante. Par exemple, si vous voulez qu’un objet rectangle se déplace au clic d’un bouton, sélectionnez un objet bouton. L’arrière-plan du nom de l’objet est mis en surbrillance pour indiquer que l’objet est sélectionné.

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

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

   Attention :
   Les événements ne s’affichent pas si le projet est toujours dans un état temporaire. Par exemple, un projet nouvellement créé est stocké dans un emplacement temporaire jusqu’à ce que vous cliquiez sur Fichier et Enregistrer tout. Après avoir enregistré le projet, vous pouvez afficher et sélectionner des événements dans le panneau Événements.

   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. Vous pouvez également consulter la liste des événements disponibles et leurs descriptions dans la rubrique Référence rapide des événements WPF.

6. Cliquez dans la zone de texte de l’événement à connecter, puis tapez-y le nom de la méthode de gestionnaire d’événements du fichier code-behind. Une fois l’opération effectuée, appuyez sur Entrée pour déplacer le focus hors de la zone de texte.

   Attention :

   Il est recommandé de copier et coller le nom de la méthode à partir du fichier code-behind vers le panneau Événements. Expression Blend génère du code pour les nouvelles méthodes de gestionnaire d’événements, sauf si le nom de la méthode existe déjà dans le fichier code-behind. En d’autres termes, si vous ne tapez pas correctement le nom d’une méthode de gestionnaire d’événements existante dans le panneau Événements d’Expression Blend, une nouvelle méthode portant le nom incorrectement tapé est créée dans le fichier code-behind. Pour cette raison, vérifiez dans le fichier code-behind qu’aucune méthode de gestionnaire d’événements vide n’a été créée lorsque vous avez terminé.

7. Enregistrez votre fichier (Ctrl+S) et testez votre application (F5) pour confirmer que le comportement attendu se produit.