Utiliza ItemTemplate para especificar la visualización de los objetos de datos. Si ItemsControl está enlazado a un objeto de la recolección y no se proporcionan instrucciones de presentación en pantalla concretas mediante DataTemplate, la interfaz de usuario resultante de cada elemento es una representación de cadena de cada objeto de la recolección subyacente.

Al establecer ItemTemplate en ItemsControl, la interfaz de usuario se genera del modo siguiente (utilizando ListBox como ejemplo):

1. Durante la generación del contenido, ItemsPanel inicia una solicitud para que ItemContainerGenerator cree un contenedor para cada elemento de datos. Para ListBox, el contenedor es ListBoxItem. El generador vuelve a llamar en ItemsControl para preparar el contenedor.

2. Una parte de la preparación implica la copia de ItemTemplate de ListBox para ser ContentTemplate de ListBoxItem.

3. Similar a todos los tipos ContentControl, la ControlTemplate de ListBoxItem contiene ContentPresenter. Cuando se aplica la plantilla, crea ContentPresenter cuyo ContentTemplate se enlaza a ContentTemplate de ListBoxItem.

4. Finalmente, ContentPresenter aplica este ContentTemplate a sí mismo y eso crea la interfaz de usuario.

Si tiene más de una DataTemplate definida y desea proporcionar la lógica para elegir mediante programación y aplicar una DataTemplate, utilice la propiedad ItemTemplateSelector.

ItemsControl proporciona gran flexibilidad para la personalización visual, así como muchas propiedades de estilo y creación de plantillas. Utilice la propiedad ItemContainerStyle o la propiedad ItemContainerStyleSelector para establecer un estilo que afecta al aspecto de los elementos que contienen los elementos de datos. Por ejemplo, para ListBox, los contenedores generados son controles ListBoxItem; para ComboBox, son controles ComboBoxItem. Para afectar al diseño de los elementos, utilice la propiedad ItemsPanel. Si utiliza la agrupación en el control, puede utilizar la propiedad GroupStyle o GroupStyleSelector.

Para obtener más información, vea Información general sobre plantillas de datos.

En el siguiente ejemplo se muestra cómo crear una DataTemplate inline. DataTemplate especifica que cada elemento de datos aparece en forma de tres elementos TextBlock dentro de StackPanel. En este ejemplo, el objeto de datos es una clase llamada Task. Observe que cada elemento TextBlock de esta plantilla está enlazado a una propiedad de la clase Task.

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}">
   <ListBox.ItemTemplate>
     <DataTemplate>
       <StackPanel>
         <TextBlock Text="{Binding Path=TaskName}" />
         <TextBlock Text="{Binding Path=Description}"/>
         <TextBlock Text="{Binding Path=Priority}"/>
       </StackPanel>
     </DataTemplate>
   </ListBox.ItemTemplate>
 </ListBox>

Es más común definir una DataTemplate en la sección de recursos para que pueda ser un objeto reutilizable, como en el ejemplo siguiente:

<Window.Resources>


...


<DataTemplate x:Key="myTaskTemplate">
  <StackPanel>
    <TextBlock Text="{Binding Path=TaskName}" />
    <TextBlock Text="{Binding Path=Description}"/>
    <TextBlock Text="{Binding Path=Priority}"/>
  </StackPanel>
</DataTemplate>


...


</Window.Resources>

Ahora puede utilizar myTaskTemplate como recurso, tal como se muestra en el ejemplo siguiente:

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}"
         ItemTemplate="{StaticResource myTaskTemplate}"/>

Para obtener el ejemplo completo, vea Introducción al ejemplo Data Templating.

Windows Vista

.NET Framework

Referencia

Otros recursos