Ajout d'une commande Shell à la barre d'outils de l'application
Cette leçon indique comment ajouter une commande à la barre d'outils Application et écrire le code qui s'exécute lorsqu'un utilisateur clique sur la commande au moment de l'exécution.La commande exécute une requête paramétrable et affiche les résultats sur un écran de recherche.
Ajouter une commande d'environnement
Dans la leçon précédente, vous avez ajouté une commande qui s'affiche sur la barre de commandes d'un écran.Vous pouvez aussi programmer un bouton de barre d'outils pour accomplir d'autres tâches, par exemple, ouvrir un autre écran, appliquer un filtre sur les données, ou même envoyer un courrier électronique.
Pour ajouter une requête paramétrable
Dans l' Explorateur de solutions, sélectionnez le nœud Customers.
Dans le menu Projet, cliquez sur Ajouter une requête.
Dans la fenêtre Propriétés, dans le champ Nom, tapez MatchCustomer.
Dans le Concepteur de requêtes, cliquez sur Ajouter un filtre.
Dans la deuxième liste déroulante, sélectionnez ContactName.
Dans la quatrième liste déroulante, sélectionnez Paramètre.
Dans la dernière liste déroulante, cliquez sur Ajouter.
Un nouveau paramètre nommé ContactName, de type String est ajouté à la section Paramètres de l' Éditeur de requêtes.
Pour ajouter un écran de recherche
Dans la barre d'outils, cliquez sur le bouton Ajouter un écran.
Dans la boîte de dialogue Ajouter un nouvel écran, dans la liste Sélectionnez un modèle d'écran, sélectionnez Rechercher un écran de données.
Dans le champ Nom de l'écran, tapez SearchCustomer.
Dans la liste Données d'écran, sélectionnez – MatchCustomer, puis cliquez sur OK.
Dans le Concepteur d'écran, sélectionnez le nœud CustomerContactName.
Dans la fenêtre Propriétés , sélectionnez la propriété Est un paramètre .
Pour ajouter une commande à la barre d'outils Application
Dans l' Explorateur de solutions, double-cliquez sur ContactList.
Dans le Concepteur d'écran, développez le nœud Arborescence de contenu de l'écran.
Dans la liste Ajouter, sélectionnez Nouveau bouton.
La boîte de dialogue Ajouter un bouton s'affiche.
Dans la boîte de dialogue Ajouter un bouton, sélectionnez Nouvelle méthode, tapez Find dans le champ Nom, puis cliquez sur OK.
Dans la fenêtre Propriétés, sélectionnez le champ Description et tapez Rechercher le contact sélectionné dans la liste de clients.
Cliquez sur le lien Choisir une image.
Dans la boîte de dialogue Sélectionner une image, cliquez sur Importer.
Dans la boîte de dialogue Ouvrir, accédez à un répertoire qui contient des images, sélectionnez une image, puis cliquez sur Ouvrir.
Cliquez sur OK pour fermer la boîte de dialogue Sélectionner une image.
Dans le volet de gauche, sélectionnez Rechercher.
Dans la fenêtre Propriétés, cliquez sur Modifier le code d'exécution.
L' Éditeur de code apparaît et affiche la méthode Find_Execute().
Dans la méthode Find_Execute(), ajoutez le code suivant.
Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName)Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName);Ce code affiche l'écran ShowSearchCustomer lorsqu'un utilisateur clique sur le bouton que vous venez de créer.
Appuyez sur F5 pour exécuter l'application.
Vérifiez la nouvelle commande en sélectionnant Howard Snyder dans la liste de contacts, puis en cliquant sur le bouton Rechercher.
.png "Les résultats de la recherche")
L'écran SearchCustomer doit s'ouvrir et afficher les données de Great Lakes Food Market.Lorsque vous cliquez sur Great Lakes Food Market dans la colonne Société, un écran Détails du client doit s'afficher.
Présentation détaillée
Cette leçon a indiqué comment créer une requête paramétrable pour retourner les Clients qui correspondent à un paramètre ContactName, et comment créer un écran de recherche basé sur la requête.Vous avez peut-être noté que l'écran SearchCustomer ne s'affiche pas dans le Menu de navigation de l'application en cours d'exécution.Les écrans basés sur des requêtes paramétrables ne peuvent être ouverts qu'en exécutant une commande et ne peuvent pas être ajoutés au menu.
Cette leçon a ensuite montré comment ajouter une commande à l'écran ContactList, lui affecter un Nom complet, une Description et une Image, et ajouter le code qui s'exécute à chaque fois qu'un utilisateur clique sur le bouton de commande.Le code exécute la méthode ShowSearchCustomer, qui affiche l'écran SearchCustomer.Le code placé entre parenthèses contient le paramètre de la méthode, dans ce cas le ContactName pour l'élément sélectionné dans la collection Contacts.
Vous avez peut-être noté que la commande s'affiche seulement sur la barre d'outils Application lorsque l'écran Liste des contacts est sélectionné.Étant donné que les commandes ajoutées à la barre d'outils sont spécifiques à l'écran, vous devez créer une commande distincte pour chaque écran.
Étapes suivantes
Dans la leçon suivante, vous apprendrez comment ajouter un élément au menu de navigation.
Prochaine leçon : Personnalisation des éléments de menu
Voir aussi
Tâches
Comment : ajouter une commande personnalisée à un écran Silverlight
Concepts
Écriture de code dans LightSwitch