Classe ItemsControl

Um ItemsControl é um tipo de Control que pode conter vários itens, como seqüências de caracteres, objetos ou outros elementos. A ilustração a seguir mostra um ListBox o controle que contém os diferentes tipos de itens a seguintes:

• Uma seqüência de caracteres.

• Um DateTime objeto.

• Um UIElement objeto.

• Um Panel o controle que contém um Ellipse e um TextBlock.

Use o Items ou o ItemsSource propriedade para especificar a coleção de usar para gerar o conteúdo do seu ItemsControl. Você pode definir o ItemsSource propriedade para qualquer tipo que implementa IEnumerable. ItemsSource é normalmente usado para exibir um conjunto de dados ou vincular um ItemsControl a um objeto da coleção.

If you do not want to use an object that implements IEnumerable to populate the ItemsControl, you can add items by using the Items property. Os itens em um ItemsControl pode ter diferentes tipos. For example, a ListBox can contain one item that is a string and another item that is an Image.

Quando o ItemsSource for definida, a Items coleção está definida como somente leitura e fixo-tamanho. Isso significa que você não pode adicionar itens à coleção diretamente. Quando ItemsSource está em uso, a configuração da propriedade para null Remove da coleção e restaura o uso de Items, que será um vazio ItemCollection.

Cada ItemsControl o tipo tem um tipo da contêiner correspondente do item. O contêiner do item correspondente para cada ItemsControl acrescenta Item para o seu nome. Por exemplo, para ListBox, os recipientes de item são ListBoxItem controles; para ComboBox, eles são ComboBoxItem controles. Você pode criar explicitamente um tipo de recipiente para cada item da ItemsControl, mas não é necessário. Quando você não cria explicitamente o tipo de recipiente, um é gerado que contém um item na coleção de item de dados. Por exemplo, se você vincular uma coleção de objetos de cadeia de caracteres para o ItemsSource propriedade de um ListBox, você não explicitamente criar ListBoxItem objetos, mas o ListBox irá gerar um para cada seqüência de caracteres. Você pode acessar um recipiente do item gerado usando o ItemContainerGenerator propriedade.

Observação

O ItemsControl não oferece suporte a contendo objetos duplicados. Dois objetos são considerados como duplicatas se a GetHashCode método para cada objeto retorna o mesmo valor. Se você tentar adicionar objetos duplicados para um ItemsControl, determinados recursos de automação da interface do usuário ou de classes que herdam da Selector podem não funcionar corretamente. Além disso, o valor retornado por GetHashCode não deve alterar para objetos que estão em um ItemsControl.

Propriedades de dependência para este controle podem ser definidas pelo estilo padrão do controle. Se uma propriedade é definida por um estilo padrão, a propriedade pode alterar de seu valor padrão quando o controle aparece no aplicativo. O estilo padrão é determinado por qual tema da área de trabalho é usado quando o aplicativo é executado. Para obter mais informações, consulte Temas padrão do WPF.

Os exemplos a seguir demonstram a ligação de dados para um ItemsControl. O primeiro exemplo cria uma classe chamada MyData isto é uma cadeia de caracteres simple coleção.

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

O exemplo a seguir vincula a ItemsSource o objeto de um ItemsControl para 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);

A ilustração a seguir mostra a ListBox controle criado no exemplo anterior.

O exemplo a seguir demonstra como preencher um ItemsControl usando o Items propriedade. O exemplo adiciona os seguintes tipos diferentes de itens para o ListBox:

• Uma seqüência de caracteres.

• Um DateTime objeto.

• Um UIElement objeto.

• Um Panel controle que contém os outros UIElement objetos.

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

A ilustração a seguir mostra a ListBox criado no exemplo anterior.

O exemplo a seguir ilustra como usar os diferentes estilos e propriedades relacionadas a modelos que são fornecidas pelo ItemsControl. O ItemsControl neste exemplo está vinculado a uma coleção de Task objetos. For demonstration purposes, the styles and templates in this example are all declared 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>

A ilustração a seguir é uma captura de tela do exemplo, quando ela é processada.

Two other style-related properties of the ItemsControl that are not shown here are GroupStyle e GroupStyleSelector.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

Referência

Outros recursos