Créer un contrôle d’éléments

Les contrôles d’éléments ont une propriété Items pouvant contenir une collection d’éléments enfants. Vous pouvez ajouter des éléments enfants de tout type à la collection d’éléments, ou vous pouvez afficher un tableau d’éléments à partir d’une source de données en utilisant une liaison de données. Les contrôles d’éléments n’ont ni propriété de contenu ni propriété d’en-tête. Des éléments enfants sont ajoutés dans l’hôte d’éléments du contrôle d’éléments qui, dans le cas d’un contrôle ListBox, est un Panneau d’empilement qui dispose les éléments dans une pile verticale. Vous ne verrez pas l’hôte d’éléments sous Objets et chronologie dans Microsoft Expression Blend, sauf si vous modifiez le modèle du contrôle d’éléments.

La procédure suivante montre comment créer un contrôle d’éléments (un contrôle ListBox) et ajouter des éléments à la collection d’éléments. Vous pouvez utiliser cette procédure avec d’autres contrôles d’éléments répertoriés sous « Types » dans la rubrique consacrée aux Types ItemsControl sur MSDN. Si vous souhaitez afficher un tableau d’éléments d’une source de données, voir la rubrique Essayez ! Créer un lecteur de News RSS.

Remarque :

Les contrôles d’éléments ne sont pas disponibles dans les projets Microsoft Silverlight 1.0. Toutefois, vous pouvez créer un calque d’objets TextBlock dans un panneau de disposition Canevas et raccorder un gestionnaire d’événements JavaScript afin de faire apparaître ou disparaître les éléments. Pour plus d’informations sur JavaScript, voir les détails relatifs aux événements de souris et scripts Silverlight.

Pour créer un contrôle d’éléments

1. Dans la boîte à outils du côté gauche d’Expression Blend, cliquez sur le bouton Bibliothèque de composants . Sous l’onglet Contrôles, cliquez sur Contrôles système (si cette option n’est pas déjà sélectionnée), puis sélectionnez ListBox dans la liste. L’icône du contrôle ListBox apparaît au-dessus du bouton Bibliothèque de composants, et est sélectionnée, prête pour l’ajout d’un contrôle ListBox à la planche graphique.

   Conseil :
   Les éléments d’interface utilisateur les plus courants (tels que le contrôle Button) sont déjà affichés dans les listes déroulantes au-dessus du bouton Bibliothèque de composants afin que vous puissiez les ajouter rapidement.

2. Pour ajouter un bouton à la planche graphique, double-cliquez sur l’icône Boîte à outils du contrôle ListBox.

   Objet ListBox créé sur la planche graphique à sa taille et à son emplacement (en haut à gauche) par défaut

   

   Conseil :
   Vous pouvez également ajouter un contrôle à la planche graphique en le sélectionnant d’abord dans la boîte à outils, puis en cliquant sur la planche graphique et en faisant glisser le curseur pour spécifier le rectangle englobant du contrôle.

   Conseil :
   Après qu’un élément de conception d’interface utilisateur, tel qu’un contrôle ListBox, est ajouté à la planche graphique, il devient un objet dans votre application.

3. Sous Objets et chronologie, double-cliquez sur l’objet ListBox pour en faire l’élément activé. Notez qu’une surbrillance jaune apparaît autour de l’élément. L’activation d’un objet permet d’ajouter un élément enfant.

   Conseil :
   Vous pouvez également activer un objet sur la planche graphique en sélectionnant d’abord l’outil Sélection dans la boîte à outils, puis en double-cliquant sur l’objet sur la planche graphique.

4. Dessinez plusieurs formes dans le contrôle ListBox à l’aide d’éléments de la boîte à outils tels que le contrôle TextBlock, Button  ou Rectangle . Notez que la liste dispose ces éléments enfants dans une pile verticale.

   Objets enfants ajoutés à un objet ListBox

   

   Remarque :
   Si vous ajoutez plus d’éléments que ne peut en contenir un contrôle d’éléments, une barre de défilement apparaît lors de l’exécution de votre application. Cela vous permet de voir les éléments supplémentaires.

   Conseil :
   Réagencez les éléments de la liste en faisant glisser les objets sous Objets et chronologie, ou sélectionnez l’outil Sélection pour les faire glisser sur la planche graphique.

5. Vous pouvez voir les éléments dans votre contrôle ListBox et en ajouter d’autres dans la fenêtre de l’Éditeur de collections. Pour ouvrir l’Éditeur de collections, cliquez sur le bouton Modifier les éléments de cette collection  en regard de la propriété Items (Collection) dans le panneau Propriétés.

6. Construisez votre projet (F5) pour voir l’application résultante.