ItemsControl, classe

ItemsControl est un type d' Control qui peut contenir des éléments complexes, tels que des chaînes, des objets, ou d'autres éléments. L'illustration suivante montre un contrôle d' ListBox qui contient différents types d'éléments suivants :

• Une chaîne de caractères.

• Un objet DateTime.

• Un objet UIElement .

• Un contrôle Panel qui contient une Ellipse et un TextBlock.

Utilisez Items ou la propriété d' ItemsSource pour spécifier la collection à utiliser pour générer le contenu de votre ItemsControl. Vous pouvez définir la propriété d' ItemsSource à tout type qui implémente IEnumerable. ItemsSource est généralement utilisé pour afficher une collection de données ou pour lier ItemsControl à un objet de collection.

Si vous ne souhaitez pas utiliser un objet qui implémente IEnumerable pour remplir ItemsControl, vous pouvez ajouter des éléments à l'aide de la propriété d' Items . Les éléments dans ItemsControl peuvent avoir des types. Par exemple, ListBox peut contenir un élément qui est une chaîne et un autre élément qui est Image.

Lorsque la propriété d' ItemsSource est définie, la collection d' Items est définie en lecture seule et à de taille fixe. Cela signifie que vous ne pouvez pas ajouter des éléments à la collection directement. Lorsque ItemsSource est en cours de utilisation, affectant à la propriété null supprime la collection et restaure l'utilisation à Items, qui sera ItemCollectionvide.

Chaque type d' ItemsControl possède un type de conteneur d'élément. Le conteneur correspondant d'élément pour chaque ItemsControl ajoute Item son nom. Par exemple, pour ListBox, les conteneurs d'élément sont des contrôles d' ListBoxItem ; pour ComboBox, ils sont des contrôles d' ComboBoxItem . Vous pouvez créer explicitement un type de conteneur pour chaque élément de ItemsControl, mais il n'est pas nécessaire. Lorsque vous ne créez pas explicitement le type de conteneur, il génère un qui contient un élément de données de la collection d'éléments. Par exemple, si vous créez une collection d'objets chaîne à la propriété d' ItemsSource d' ListBox, vous ne créez pas explicitement des objets d' ListBoxItem , mais ListBox génère un pour chaque chaîne. Vous pouvez accéder à un conteneur généré d'élément à l'aide de la propriété d' ItemContainerGenerator .

Remarque

ItemsControl ne prend pas en charge contenir des objets en double. Deux objets sont considérés comme des doublons si la méthode d' GetHashCode pour chaque objet retourne la même valeur. Si vous tentez d'ajouter des objets en double en ItemsControl, certaines fonctionnalités UI Automation ou les classes qui héritent d' Selector peuvent ne pas fonctionner correctement. En outre, la valeur retournée par GetHashCode ne doit pas changer pour les objets qui se trouvent dans ItemsControl.

Les propriétés de dépendance pour ce contrôle peuvent être définies par le style par défaut du contrôle. Si une propriété est définie par un style par défaut, la propriété peut changer de sa valeur par défaut lorsque le contrôle s'affiche dans l'application. Il détermine le style par défaut par lequel le thème du bureau est utilisé lorsque l'application s'exécute. Pour plus d'informations, consultez Thèmes par défaut WPF.

Les exemples suivants montrent la liaison de données à ItemsControl.
Le premier exemple crée une classe appelée MyData qui est une simple collection de chaîne de caractères.

public class MyData : ObservableCollection<string>
{
    public MyData()
    {
        Add("Item 1");
        Add("Item 2");
        Add("Item 3");
    }
}

l'exemple suivant lie l'objet d' ItemsSource d' ItemsControl à MyData.

<!--Create an instance of MyData as a resource.-->
<src:MyData x:Key="dataList"/>


...


<ListBox ItemsSource="{Binding Source={StaticResource dataList}}"/>

Dim listBox1 As New ListBox()
Dim listData As New MyData()
Dim binding1 As New Binding()

binding1.Source = listData
listBox1.SetBinding(ListBox.ItemsSourceProperty, binding1)

ListBox listBox1 = new ListBox();
MyData listData = new MyData();
Binding binding1 = new Binding();

binding1.Source = listData;
listBox1.SetBinding(ListBox.ItemsSourceProperty, binding1);

l'illustration suivante montre le contrôle d' ListBox créé dans l'exemple précédent.

l'exemple suivant montre comment remplir un ItemsControl à l'aide de la propriété Items. L'exemple ajoute les différents types d'éléments suivants à la ListBox :

• Une chaîne de caractères.

• Un objet DateTime.

• Un objet UIElement .

• Un contrôle d' Panel qui contient d'autres objets d' UIElement .

<!--Create a ListBox that contains a string, a Rectangle,
     a Panel, and a DateTime object. These items can be accessed
     via the Items property.-->
<ListBox xmlns:sys="clr-namespace:System;assembly=mscorlib"
         Name="simpleListBox">

  <!-- The <ListBox.Items> element is implicitly used.-->
  This is a string in a ListBox

  <sys:DateTime>2004/3/4 13:6:55</sys:DateTime>

  <Rectangle Height="40" Width="40"  Fill="Blue"/>

  <StackPanel Name="itemToSelect">
    <Ellipse Height="40" Fill="Blue"/>
    <TextBlock>Text below an Ellipse</TextBlock>
  </StackPanel>

  <TextBlock>String in a TextBlock</TextBlock>
  <!--</ListBox.Items>-->
</ListBox>

' Create a Button with a string as its content.
listBox1.Items.Add("This is a string in a ListBox")

' Create a Button with a DateTime object as its content.
Dim dateTime1 As New DateTime(2004, 3, 4, 13, 6, 55)

listBox1.Items.Add(dateTime1)

' Create a Button with a single UIElement as its content.
Dim rect1 As New Rectangle()
rect1.Width = 40
rect1.Height = 40
rect1.Fill = Brushes.Blue
listBox1.Items.Add(rect1)

' Create a Button with a panel that contains multiple objects 
' as its content.
Dim ellipse1 As New Ellipse()
Dim textBlock1 As New TextBlock()

ellipse1.Width = 40
ellipse1.Height = 40
ellipse1.Fill = Brushes.Blue

textBlock1.TextAlignment = TextAlignment.Center
textBlock1.Text = "Text below an Ellipse"

stackPanel1.Children.Add(ellipse1)
stackPanel1.Children.Add(textBlock1)

listBox1.Items.Add(stackPanel1)

// Add a String to the ListBox.
listBox1.Items.Add("This is a string in a ListBox");

// Add a DateTime object to a ListBox.
DateTime dateTime1 = new DateTime(2004, 3, 4, 13, 6, 55);

listBox1.Items.Add(dateTime1);

// Add a Rectangle to the ListBox.
Rectangle rect1 = new Rectangle();
rect1.Width = 40;
rect1.Height = 40;
rect1.Fill = Brushes.Blue;
listBox1.Items.Add(rect1);

// Add a panel that contains multpile objects to the ListBox.
Ellipse ellipse1 = new Ellipse();
TextBlock textBlock1 = new TextBlock();

ellipse1.Width = 40;
ellipse1.Height = 40;
ellipse1.Fill = Brushes.Blue;

textBlock1.TextAlignment = TextAlignment.Center;
textBlock1.Text = "Text below an Ellipse";

stackPanel1.Children.Add(ellipse1);
stackPanel1.Children.Add(textBlock1);

listBox1.Items.Add(stackPanel1);

l'illustration suivante montre ListBox créé dans l'exemple précédent.

L'exemple suivant montre comment utiliser un style différent et les propriétés création de modèles-mises en relation qui sont fournis par ItemsControl. ItemsControl dans cet exemple est lié à une collection d'objets d' Task . À des fins de démonstration, les styles et les modèles dans cet exemple sont déclarés inline.

<ItemsControl Margin="10"
              ItemsSource="{Binding Source={StaticResource myTodoList}}">
  <!--The ItemsControl has no default visual appearance.
      Use the Template property to specify a ControlTemplate to define
      the appearance of an ItemsControl. The ItemsPresenter uses the specified
      ItemsPanelTemplate (see below) to layout the items. If an
      ItemsPanelTemplate is not specified, the default is used. (For ItemsControl,
      the default is an ItemsPanelTemplate that specifies a StackPanel.-->
  <ItemsControl.Template>
    <ControlTemplate TargetType="ItemsControl">
      <Border BorderBrush="Aqua" BorderThickness="1" CornerRadius="15">
        <ItemsPresenter/>
      </Border>
    </ControlTemplate>
  </ItemsControl.Template>
  <!--Use the ItemsPanel property to specify an ItemsPanelTemplate
      that defines the panel that is used to hold the generated items.
      In other words, use this property if you want to affect
      how the items are laid out.-->
  <ItemsControl.ItemsPanel>
    <ItemsPanelTemplate>
      <WrapPanel />
    </ItemsPanelTemplate>
  </ItemsControl.ItemsPanel>
  <!--Use the ItemTemplate to set a DataTemplate to define
      the visualization of the data objects. This DataTemplate
      specifies that each data object appears with the Proriity
      and TaskName on top of a silver ellipse.-->
  <ItemsControl.ItemTemplate>
    <DataTemplate>
      <DataTemplate.Resources>
        <Style TargetType="TextBlock">
          <Setter Property="FontSize" Value="18"/>
          <Setter Property="HorizontalAlignment" Value="Center"/>
        </Style>
      </DataTemplate.Resources>
      <Grid>
        <Ellipse Fill="Silver"/>
        <StackPanel>
          <TextBlock Margin="3,3,3,0"
                     Text="{Binding Path=Priority}"/>
          <TextBlock Margin="3,0,3,7"
                     Text="{Binding Path=TaskName}"/>
        </StackPanel>
      </Grid>
    </DataTemplate>
  </ItemsControl.ItemTemplate>
  <!--Use the ItemContainerStyle property to specify the appearance
      of the element that contains the data. This ItemContainerStyle
      gives each item container a margin and a width. There is also
      a trigger that sets a tooltip that shows the description of
      the data object when the mouse hovers over the item container.-->
  <ItemsControl.ItemContainerStyle>
    <Style>
      <Setter Property="Control.Width" Value="100"/>
      <Setter Property="Control.Margin" Value="5"/>
      <Style.Triggers>
        <Trigger Property="Control.IsMouseOver" Value="True">
          <Setter Property="Control.ToolTip"
                  Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                          Path=Content.Description}"/>
        </Trigger>
      </Style.Triggers>
    </Style>
  </ItemsControl.ItemContainerStyle>
</ItemsControl>

L'illustration suivante est une capture d'écran de l'exemple lorsqu'elle est affichée.

Deux autres propriétés relatives au style d' ItemsControl qui ne sont pas présentées ici sont GroupStyle et GroupStyleSelector.

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources