ItemsControl.ItemTemplateSelector ItemsControl.ItemTemplateSelector ItemsControl.ItemTemplateSelector ItemsControl.ItemTemplateSelector Property

Definición

Obtiene o establece la lógica personalizada para elegir una plantilla que se utiliza para mostrar cada elemento.Gets or sets the custom logic for choosing a template used to display each item.

public:
 property System::Windows::Controls::DataTemplateSelector ^ ItemTemplateSelector { System::Windows::Controls::DataTemplateSelector ^ get(); void set(System::Windows::Controls::DataTemplateSelector ^ value); };
[System.ComponentModel.Bindable(true)]
public System.Windows.Controls.DataTemplateSelector ItemTemplateSelector { get; set; }
member this.ItemTemplateSelector : System.Windows.Controls.DataTemplateSelector with get, set
Public Property ItemTemplateSelector As DataTemplateSelector

Valor de propiedad

Un objeto DataTemplateSelector personalizado que proporciona la lógica y devuelve una DataTemplate.A custom DataTemplateSelector object that provides logic and returns a DataTemplate. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo siguiente, el auctionItemDataTemplateSelector nombre del recurso (correspondiente a AuctionItemDataTemplateSelector una clase) se asigna ItemsControla ItemTemplateSelector la propiedad de.In the following example, the auctionItemDataTemplateSelector resource name (corresponding to an AuctionItemDataTemplateSelector class) is assigned to the ItemTemplateSelector property of the ItemsControl.

<ItemsControl 
   Template="{StaticResource ScrollTemplate}" 
   ItemsSource="{Binding Source={StaticResource items_list}}"
   ItemTemplateSelector="{StaticResource auctionItemDataTemplateSelector}" >
   <ItemsControl.ItemsPanel>
      <ItemsPanelTemplate>
         <StackPanel />
      </ItemsPanelTemplate>
   </ItemsControl.ItemsPanel>
</ItemsControl>

En el ejemplo siguiente se muestra la implementación AuctionItemDataTemplateSelector de la clase con una invalidación SelectTemplate del método:The following example shows the implementation of the AuctionItemDataTemplateSelector class with an override of the SelectTemplate method:

using System.Windows;
using System.Windows.Controls;

namespace SDKSample
{
    public class AuctionItemDataTemplateSelector : DataTemplateSelector
    {
        public override DataTemplate 
            SelectTemplate(object item, DependencyObject container)
        {
            FrameworkElement element = container as FrameworkElement;

            if (element != null && item != null && item is AuctionItem)
            {
                AuctionItem auctionItem = item as AuctionItem;
                Window window = Application.Current.MainWindow;

                switch (auctionItem.SpecialFeatures)
                {
                    case SpecialFeatures.None:
                        return 
                            element.FindResource("AuctionItem_None") 
                            as DataTemplate;
                    case SpecialFeatures.Color:
                        return 
                            element.FindResource("AuctionItem_Color") 
                            as DataTemplate;
                }
            }

            return null;
        }
    }


}

Namespace SDKSample
    Public Class AuctionItemDataTemplateSelector
        Inherits DataTemplateSelector
        Public Overrides Function SelectTemplate(ByVal item As Object, ByVal container As DependencyObject) As DataTemplate

            Dim element As FrameworkElement = TryCast(container, FrameworkElement)

            If element isnot Nothing andalso item IsNot Nothing AndAlso TypeOf item Is AuctionItem Then

                Dim auctionItem As AuctionItem = TryCast(item, AuctionItem)

                Select Case auctionItem.SpecialFeatures
                    Case SpecialFeatures.None
                        Return TryCast(element.FindResource("AuctionItem_None"), DataTemplate)
                    Case SpecialFeatures.Color
                        Return TryCast(element.FindResource("AuctionItem_Color"), DataTemplate)
                End Select
            End If

            Return Nothing
        End Function
    End Class
End Namespace

En este caso, dentro del SelectTemplate método de la clase, hay lógica para devolver la plantilla adecuada en función del valor de la SpecialFeatures propiedad del item objeto pasado.In this case, within the SelectTemplate method of the class, there is logic to return the appropriate template based on the value of the SpecialFeatures property of the item object passed. La plantilla que se va a devolver se encuentra en los recursos del Window elemento de envoltura.The template to return is found in the resources of the enveloping Window element.

Cuando se establece la ItemTemplateSelector propiedad ItemsControl , se dirige a para que llame automáticamente SelectTemplate al método AuctionItemDataTemplateSelector de ItemsControl para cada uno de los elementos de la colección a la que está enlazado.When you set the ItemTemplateSelector property, the ItemsControl is directed to automatically call the SelectTemplate method of AuctionItemDataTemplateSelector for each of the items in the collection to which the ItemsControl is bound. La llamada pasa el elemento de datos como un objeto.The call passes the data item as an object. El DataTemplate objeto devuelto por el método se usa para mostrar ese elemento de datos.The DataTemplate that is returned by the method is then used to display that data item.

Para ver otro ejemplo, consulte información general sobre plantillas de datos.For another example, see Data Templating Overview.

Comentarios

Utilice ItemTemplate para especificar la visualización de los objetos de datos.You use the ItemTemplate to specify the visualization of the data objects. Si tiene más de una plantilla definida y desea proporcionar lógica para que se devuelva una plantilla, use esta propiedad.If you have more than one template defined and want to supply logic to return a template to use, then you use this property. Tenga en cuenta que esta propiedad se ItemTemplate omite si se establece.Note that this property is ignored if ItemTemplate is set.

Proporciona ItemsControl una gran flexibilidad para la personalización visual y proporciona muchas propiedades de estilo y plantillas.The ItemsControl provides great flexibility for visual customization and provides many styling and templating properties. Utilice la ItemContainerStyle propiedad o la ItemContainerStyleSelector propiedad para establecer un estilo que afecte a la apariencia de los elementos que contienen los elementos de datos.Use the ItemContainerStyle property or the ItemContainerStyleSelector property to set a style to affect the appearance of the elements that contain the data items. Por ejemplo, para ListBox, los contenedores generados ListBoxItem son controles; ComboBoxpara, son ComboBoxItem controles.For example, for ListBox, the generated containers are ListBoxItem controls; for ComboBox, they are ComboBoxItem controls. Para afectar al diseño de los elementos, use la ItemsPanel propiedad.To affect the layout of the items, use the ItemsPanel property. Si está utilizando la agrupación en el control, puede usar la GroupStyle propiedad o. GroupStyleSelectorIf you are using grouping on your control, you can use the GroupStyle or GroupStyleSelector property.

Para obtener más información, consulte Información general sobre plantillas de datos.For more information, see Data Templating Overview.

Uso de atributos XAMLXAML Attribute Usage

<object ItemTemplateSelector="ResourceExtension SelectorResourceKey"/>  

Valores XAMLXAML Values

ResourceExtensionResourceExtension
Uno de los siguientes: StaticResource, o DynamicResource.One of the following: StaticResource, or DynamicResource. A menos que los propios estilos contengan referencias a posibles referencias en tiempo de ejecución, como recursos StaticResource del sistema o preferencias del usuario, normalmente se recomienda la referencia a un estilo para el rendimiento.Unless the styles themselves contain references to potential run-time references such as system resources or user preferences, StaticResource reference to a style is usually recommended for performance.

SelectorResourceKeySelectorResourceKey
x:Keyvalor de cadena que hace referencia al selector que se solicita como un recurso.x:Key string value referring to the selector being requested as a resource.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ItemTemplateSelectorProperty
Propiedades de metadatos establecidas entrueMetadata properties set to true NingunaNone

Se aplica a

Consulte también: