Partager via

Comment : ajouter un contrôle personnalisé à un écran Silverlight

  • Article

Vous pouvez ajouter des contrôles Silverlight à un écran LightSwitch.Les contrôles Silverlight vous permettent d'afficher ou de collecter des informations au-delà des fonctionnalités des contrôles LightSwitch intégrés.

Vous pouvez utiliser les contrôles inclus dans le runtime Silverlight et le Kit de développement logiciel (SDK) Silverlight.Vous pouvez également utiliser des contrôles que vous créez à l'aide des modèles de projet Silverlight, par exemple, ceux qui sont disponibles dans Visual Studio 2010.Les deux types de contrôles sont connus sous le nom de contrôles personnalisés dans LightSwitch.

Pour plus d'informations sur la création de contrôles personnalisés en utilisant des modèles de projet Silverlight dans Visual Studio, consultez Concepts de base des contrôles (Démarrage rapide Silverlight) (page éventuellement en anglais).

Ajout de nouveaux contrôles et remplacement des contrôles existants

Vous pouvez ajouter un contrôle personnalisé à un écran, en tant que nouveau contrôle ou en remplacement d'un contrôle LightSwitch existant.

Pour ajouter un contrôle personnalisé à un écran

  1. Dans l' Arborescence de contenu de l'écran, sélectionnez un groupe.

  2. En haut du Concepteur d'écran, cliquez sur Ajouter un élément de disposition, puis cliquez sur Contrôle personnalisé.

  3. Dans la boîte de dialogue Ajouter un contrôle personnalisé, développez le nœud de l'assembly, développez le nœud de l'espace de noms, puis sélectionnez le nœud du contrôle.

    Si l'assembly de votre choix ne s'affiche pas dans la boîte de dialogue Ajouter un contrôle personnalisé, cliquez sur Ajouter une référence.Dans la boîte de dialogue Ajouter une référence, sélectionnez un assembly ou un projet local qui contient le contrôle que vous souhaitez utiliser, puis cliquez sur OK.

    [!REMARQUE]

    Si vous avez créé ce contrôle en utilisant des modèles de projet Silverlight dans Visual Studio, et vous liez le contrôle aux données en modifiant le XAML du contrôle, vous n'avez pas à effectuer l'étape suivante.Pour plus d'informations sur la liaison d'un contrôle personnalisé aux données en modifiant le XAML du contrôle, consultez Utilisation de contrôles personnalisés pour améliorer l'interface utilisateur de votre application LightSwitch (page éventuellement an anglais).Si le contrôle personnalisé est un contrôle Silverlight intégré, ou si vous avez créé ce contrôle en utilisant des modèles de projet Silverlight dans Visual Studio, mais que vous souhaitez lier le contrôle aux données à l'aide de LightSwitch, passez à l'étape suivante.

  4. Dans le champ Spécifier les données du nouveau contrôle personnalisé, tapez le nom des données d'écran que vous souhaitez lier au contrôle, puis cliquez sur OK.

    Par exemple, si vous souhaitez qu'une zone de liste personnalisée affiche des noms d'une collection nommée CustomerSet, tapez CustomerSet.Si vous souhaitez que le contrôle affiche le nom du client sélectionné actuellement, tapez CustomerSet.SelectedItem.ContactName.

  5. Ajoutez le code qui lie les données à une propriété spécifique du contrôle.Pour plus d'informations, consultez Liaison de données à une propriété du contrôle personnalisé plus loin dans ce document.

Pour utiliser un contrôle personnalisé pour remplacer un contrôle existant

  1. Dans l' Arborescence de contenu de l'écran, dans la liste déroulante située en regard du contrôle à remplacer, sélectionnez Contrôle personnalisé.

  2. Dans la fenêtre Propriétés, en regard du champ Contrôle personnalisé, cliquez sur Modifier.

  3. Dans la boîte de dialogue Ajouter un contrôle personnalisé, développez le nœud de l'assembly, développez le nœud de l'espace de noms, sélectionnez le nœud du contrôle, puis cliquez sur OK.

    Si l'assembly qui contient le contrôle ne s'affiche pas dans la boîte de dialogue Ajouter un contrôle personnalisé, cliquez sur Ajouter une référence.Dans la boîte de dialogue Ajouter une référence, sélectionnez un assembly ou un projet local qui contient le contrôle que vous souhaitez utiliser, puis cliquez sur OK.

  4. Ajoutez le code qui lie les données à une propriété spécifique du contrôle.Pour plus d'informations, consultez Liaison de données à une propriété du contrôle personnalisé plus loin dans ce document.

Liaison de données à une propriété du contrôle personnalisé

Vous devez lier les données spécifiées dans la boîte de dialogue Ajouter un contrôle personnalisé à une propriété spécifique du contrôle personnalisé.

Pour lier des données à une propriété du contrôle personnalisé

  1. Dans le Concepteur d'écran, cliquez sur la flèche proche du bouton Écrire le code, puis cliquez sur une méthode.

    [!REMARQUE]

    Choisissez une méthode exécutée avant que les données s'affichent dans le contrôle au moment de l'exécution, par exemple, CustomerListDetail_Activated.

    Un bloc de méthode s'affiche dans l'Éditeur de code.

  2. Dans le bloc de méthode, ajoutez le code qui lie les données d'écran à une propriété du contrôle personnalisé.

    L'exemple suivant référence un contrôle zone de liste déroulante personnalisé nommé Customers.Ce code lie une collecte de données spécifiée dans la boîte de dialogue Ajouter un contrôle personnalisé à une propriété spécifique de la zone de liste.Ce code spécifie également que les données peuvent être modifiées à l'aide de ce contrôle.

    Private Sub CustomersListDetail_Activated()
    Me.FindControl("Customers").SetBinding( _
        System.Windows.Controls.ListBox.ItemsSourceProperty, _
                "Value", System.Windows.Data.BindingMode.TwoWay)
End Sub

    partial void CustomersListDetail_Activated()
{
    this.FindControl("Customers").SetBinding(
        System.Windows.Controls.ListBox.ItemsSourceProperty,
        "Value", System.Windows.Data.BindingMode.TwoWay);
}

Voir aussi

Tâches

Comment : ajouter un contrôle personnalisé à un écran Silverlight

Comment : Concevoir un écran Silverlight à l'aide du concepteur d'écran

Comment : Ajouter des données à un écran

Comment : ajouter une propriété locale à un écran Silverlight

Comment : ajouter une commande personnalisée à un écran Silverlight

Concepts

Visite du concepteur d'écran