Classe ItemsControl

ItemsControl è un tipo di Control che può contenere più elementi, ad esempio stringhe, oggetti, o altri elementi. In la figura seguente viene illustrato un controllo di ListBox che contiene i seguenti tipi diversi di elementi:

• una stringa.

• un oggetto di DateTime .

• un oggetto di UIElement .

• un controllo di Panel che contiene Ellipse e TextBlock.

Utilizzare Items o la proprietà di ItemsSource per specificare la raccolta da utilizzare per generare il contenuto di ItemsControl. È possibile impostare la proprietà di ItemsSource a qualsiasi tipo che implementa IEnumerable. ItemsSource in genere utilizzato per visualizzare una raccolta dati o per associare ItemsControl a un oggetto Collection.

Se non si desidera utilizzare un oggetto che implementa IEnumerable per popolare ItemsControl, è possibile aggiungere elementi utilizzando la proprietà di Items . Gli elementi in ItemsControl possono includere tipi diversi. Ad esempio, ListBox può contenere un elemento che rappresenta una stringa e un altro elemento che è Image.

Quando la proprietà di ItemsSource è impostata, la raccolta di Items è di sola lettura e a di dimensioni fisse. Ciò significa che non è possibile aggiungere direttamente gli elementi alla raccolta. Quando ItemsSource viene utilizzato, impostando la proprietà su null cancella la raccolta e ripristina l'utilizzo a Items, che verranno ItemCollectionvuoto.

Ogni tipo di ItemsControl dispone di un tipo corrispondente del contenitore di elementi. Il contenitore di elementi corrispondente per ciascun ItemsControl aggiunge Item al nome. Ad esempio, per ListBox, i contenitori di elementi sono controlli di ListBoxItem ; per ComboBox, sono controlli di ComboBoxItem . È possibile creare esplicitamente un tipo di contenitore per ogni elemento in ItemsControl, ma non è necessario. Quando non è necessario creare in modo esplicito il tipo del contenitore, ne viene generato che contiene un elemento dati nella raccolta di elementi. Ad esempio, se si associa una raccolta di oggetti stringa alla proprietà di ListBox, è di ItemsSource non è necessario creare in modo esplicito gli oggetti di ListBoxItem , ma ListBox genererà una per ogni stringa. È possibile accedere a un contenitore di elementi generato utilizzando la proprietà di ItemContainerGenerator .

Nota

ItemsControl non supporta contenere oggetti duplicati. Due oggetti sono considerati duplicati se il metodo di GetHashCode per ogni oggetto restituisce lo stesso valore. Se si tenta di aggiungere gli oggetti duplicati in ItemsControl, a determinate funzionalità di automazione interfaccia utente o le classi che ereditano da Selector non funzionare correttamente. Inoltre, il valore restituito da GetHashCode non deve essere modificato per gli oggetti presenti in ItemsControl.

Le proprietà di dipendenza per questo controllo possono essere impostate dallo stile predefinito del controllo. Se una proprietà è impostata da uno stile predefinito, la proprietà può variare dal valore predefinito quando il controllo viene visualizzato nell' applicazione. Lo stile predefinito è determinato dal tema desktop viene utilizzato quando l'applicazione è in esecuzione. Per ulteriori informazioni, vedere Temi predefiniti WPF.

In gli esempi riportati i dati a ItemsControl. In il primo esempio viene creato MyData chiamato classe che rappresenta una raccolta semplice della stringa.

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

In l ' esempio seguente viene associato l'oggetto di ItemsSource di ItemsControl a 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);

In la figura seguente viene mostrato il controllo di ListBox creato nell' esempio precedente.

In l ' esempio seguente viene illustrato come compilare ItemsControl utilizzando la proprietà di Items . In questo esempio vengono aggiunti i seguenti tipi diversi di elementi a ListBox:

• una stringa.

• un oggetto di DateTime .

• un oggetto di UIElement .

• Un controllo di Panel che contiene l'altro UIElement oggetti.

<!--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);

In la figura seguente viene illustrata ListBox creato nell' esempio precedente.

In l ' esempio seguente viene illustrato come applicare uno stile diverso e le proprietà templating-correlate fornite da ItemsControl. ItemsControl in questo esempio è associato a una raccolta di oggetti di Task . A scopo dimostrativo, gli stili e i modelli in questo esempio sono tutti dichiarati 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'illustrazione seguente è disponibile una schermata dell' esempio quando viene eseguito il rendering.

Altre due proprietà aggiuntive di ItemsControl che non sono illustrate in questo argomento vengono GroupStyle e GroupStyleSelector.

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti

Altre risorse