Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

SimpleListBox et SimpleListBoxItem (prise en charge de WPF dans Blend)

Cette page s’applique uniquement aux projets WPF

La zone de liste est un contrôle d’éléments sous forme de liste déroulante. Vous pouvez placer du contenu dans une zone de liste dans Blend for Visual Studio en double-cliquant sur la zone de liste et en y dessinant un objet (un rectangle par exemple). Vous pouvez également cliquer avec le bouton droit sur la zone de liste dans le panneau Objets et chronologie, puis cliquer sur Ajouter SimpleListBoxItem pour ajouter des éléments individuels à la collection, ou cliquer sur Lier ItemsSource aux données pour générer la collection d’objets SimpleListBoxItem à partir d’une source de données. Si vous ajoutez des éléments individuels à la collection, vous pouvez réorganiser les éléments en double-cliquant sur la zone de liste pour la rendre active, et en faisant glisser les éléments pour obtenir l’ordre souhaité. Vous pouvez définir quel élément est sélectionné à l'aide de la propriété SelectedIndex de la zone de liste.



Vue de planche graphique d’un contrôle SimpleListBox après l’ajout de deux éléments

JJ170163.542edff2-bb86-4d80-902d-93810083b1a9(fr-fr,VS.120).png

Le modèle de contrôle SimpleListBox est composé des éléments suivants :

  • Un panneau Grid , qui sert à contenir plusieurs enfants dans la zone de liste. La Grid est également utilisée pour permettre à un concepteur d’interface utilisateur d’application d’ajouter plus facilement des objets au modèle.

  • Un élément Border , qui est utilisé parce qu’il inclut une propriété BorderThickness pouvant être liée par modèle à la propriété BorderThickness du contrôle de zone de liste auquel ce modèle est appliqué.

  • Un élément ScrollViewer , qui est utilisé pour permettre à l’utilisateur de l’application de faire défiler la liste si elle est trop longue.

  • Un élément StackPanel , qui est contenu dans l’objet ScrollViewer et qui dispose les éléments. La propriété IsItemsHost de l’élément StackPanel prend la valeur True pour identifier l’objet ScrollViewer comme celui qui affiche les éléments du contrôle de zone de liste auquel le modèle est appliqué. Vous pouvez remplacer l’objet StackPanel par un autre objet de panneau en cliquant avec le bouton droit sur l’objet StackPanel dans le panneau Objets et chronologie, puis en sélectionnant Modifier le type de disposition pour obtenir un autre panneau tel que le panneau UniformGrid.

Le modèle de contrôle SimpleListBoxItem est composé des éléments suivants :

  • Un panneau Grid , qui sert à contenir plusieurs enfants dans l’élément de zone de liste. Une Grid est aussi utilisée pour permettre à un concepteur d’ajouter plus facilement des objets au modèle.

  • Un élément Border , qui est utilisé parce qu’il inclut une propriété BorderThickness pouvant être liée par modèle à la propriété BorderThickness du contrôle de bouton auquel ce modèle est appliqué.

  • Un élément ContentPresenter , qui est contenu dans l’objet Grid et qui est automatiquement lié à la propriété Content du contrôle d’éléments auquel ce modèle est appliqué.

Des déclencheurs de propriété dans le modèle de contrôle sont utilisés pour que le contrôle réagisse aux changements de propriétés. Vous pouvez cliquer sur les éléments du panneau Déclencheurs pour voir les propriétés qui changent lorsqu'un déclencheur est actif. Par exemple, dans le modèle de la zone de liste, lorsque la propriété IsSelected de l’élément de zone de liste a la valeur True, la couleur d’arrière-plan de l’élément change. Dans le modèle de l’élément de la zone de liste, lorsque la propriété IsHighlighted a la valeur True, la propriété Background de l’objet Border change pour indiquer quel élément est sélectionné dans la zone de liste.

Les ressources pinceau suivantes dans le dictionnaire de ressources SimpleStyles.xaml sont utilisées par les modèles SimpleListBox et SimpleListBoxItem :

  • La propriété Background est définie à l’aide de WindowBackgroundBrush si aucun déclencheur n’est actif et à l’aide de DisabledBackgroundBrush si IsEnabled a la valeur False.

  • La propriété BorderBrush est définie à l’aide de SolidBorderBrush si aucun déclencheur n’est actif et à l’aide de DisabledBorderBrush si IsEnabled a la valeur False.

  • Si le modèle SimpleListBox est rempli avec des éléments qui utilisent le modèle SimpleListBoxItem, la propriété Background de l’élément est définie à l’aide de SelectedBackgroundBrush lorsqu’un élément est sélectionné, et la propriété Foreground est définie à l’aide de DisabledForegroundBrush si IsEnabled a la valeur False.

Afficher: