ItemsControl.ItemTemplateSelector Eigenschaft

Definition

Ruft die benutzerdefinierte Logik für das Auswählen einer Vorlage ab, die zum Anzeigen der einzelnen Elemente verwendet wird, oder legt diese fest.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

Eigenschaftswert

DataTemplateSelector

Ein benutzerdefiniertes DataTemplateSelector-Objekt, das Logik bereitstellt und eine DataTemplate zurückgibt.A custom DataTemplateSelector object that provides logic and returns a DataTemplate. Der Standardwert lautet null.The default is null.

Attribute

Beispiele

Im folgenden Beispiel wird der auctionItemDataTemplateSelector Ressourcen Name (entsprechend einer AuctionItemDataTemplateSelector-Klasse) der ItemTemplateSelector-Eigenschaft der ItemsControlzugewiesen.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>

Im folgenden Beispiel wird die Implementierung der AuctionItemDataTemplateSelector-Klasse mit einer außer Kraft setzung der SelectTemplate-Methode veranschaulicht: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

In diesem Fall gibt es in der SelectTemplate-Methode der-Klasse eine Logik, die die entsprechende Vorlage basierend auf dem Wert der SpecialFeatures-Eigenschaft des item Objekts zurückgibt.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. Die zurück zugebende Vorlage befindet sich in den Ressourcen des umschließenden Window-Elements.The template to return is found in the resources of the enveloping Window element.

Wenn Sie die ItemTemplateSelector-Eigenschaft festlegen, wird der ItemsControl umgeleitet, um für jedes Element in der Auflistung, an das die ItemsControl gebunden ist, automatisch die SelectTemplate-Methode der AuctionItemDataTemplateSelector aufzurufen.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. Der-Rückruf übergibt das Datenelement als-Objekt.The call passes the data item as an object. Der DataTemplate, der von der-Methode zurückgegeben wird, wird dann verwendet, um das Datenelement anzuzeigen.The DataTemplate that is returned by the method is then used to display that data item.

Ein weiteres Beispiel finden Sie unter Übersicht über DatenVorlagen.For another example, see Data Templating Overview.

Hinweise

Sie verwenden die ItemTemplate, um die Visualisierung der Datenobjekte anzugeben.You use the ItemTemplate to specify the visualization of the data objects. Wenn Sie mehr als eine Vorlage definiert haben und Logik zum Zurückgeben einer Vorlage angeben möchten, verwenden Sie diese Eigenschaft.If you have more than one template defined and want to supply logic to return a template to use, then you use this property. Beachten Sie, dass diese Eigenschaft ignoriert wird, wenn ItemTemplate festgelegt ist.Note that this property is ignored if ItemTemplate is set.

Die ItemsControl bietet eine hohe Flexibilität bei der visuellen Anpassung und bietet viele Formatierungs-und Vorlagen Eigenschaften.The ItemsControl provides great flexibility for visual customization and provides many styling and templating properties. Verwenden Sie die ItemContainerStyle-Eigenschaft oder die ItemContainerStyleSelector-Eigenschaft, um einen Stil festzulegen, der sich auf die Darstellung der Elemente auswirkt, die die Datenelemente enthalten.Use the ItemContainerStyle property or the ItemContainerStyleSelector property to set a style to affect the appearance of the elements that contain the data items. Beispielsweise sind die generierten Container für ListBoxListBoxItem-Steuerelementen. bei ComboBoxhandelt es sich um ComboBoxItem-Steuerelemente.For example, for ListBox, the generated containers are ListBoxItem controls; for ComboBox, they are ComboBoxItem controls. Verwenden Sie die ItemsPanel-Eigenschaft, um das Layout der Elemente zu beeinflussen.To affect the layout of the items, use the ItemsPanel property. Wenn Sie die Gruppierung für das Steuerelement verwenden, können Sie die GroupStyle-oder GroupStyleSelector-Eigenschaft verwenden.If you are using grouping on your control, you can use the GroupStyle or GroupStyleSelector property.

Weitere Informationen finden Sie unter Übersicht über Datenvorlagen.For more information, see Data Templating Overview.

Verwendung von XAML-AttributenXAML Attribute Usage

<object ItemTemplateSelector="ResourceExtension SelectorResourceKey"/>  

XAML-WerteXAML Values

ResourceextensionResourceExtension
Eines der folgenden: StaticResourceoder DynamicResource.One of the following: StaticResource, or DynamicResource. Wenn die Stile selbst keine Verweise auf potenzielle Lauf Zeit Verweise enthalten, wie z. b. Systemressourcen oder Benutzereinstellungen, wird in der Regel StaticResource Verweis auf einen Stil für die Leistung empfohlen.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:Key Zeichen folgen Wert, der sich auf den als Ressource angeforderten Selektor bezieht.x:Key string value referring to the selector being requested as a resource.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field ItemTemplateSelectorProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch