ItemsControl.ItemTemplateSelector Eigenschaft

Definition

Ruft die benutzerdefinierte Logik für das Auswählen einer Vorlage ab, mit der die einzelnen Elemente angezeigt werden, oder legt diese Logik 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

Ein benutzerdefiniertes DataTemplateSelector-Objekt, das Logik bereitstellt und ein DataTemplate zurückgibt.A custom DataTemplateSelector object that provides logic and returns a DataTemplate. Die Standardeinstellung ist null.The default is null.

Attribute

Beispiele

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

Das folgende Beispiel zeigt die Implementierung AuctionItemDataTemplateSelector der-Klasse mit einer außer Kraft SelectTemplate setzung der-Methode: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 SelectTemplate der-Methode der-Klasse eine Logik, die die entsprechende Vorlage basierend auf dem Wert SpecialFeatures der-Eigenschaft des item zurückgegebenen-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 ItemTemplateSelector die-Eigenschaft festlegen, ItemsControl wird der umgeleitet, um automatisch SelectTemplate die- AuctionItemDataTemplateSelector Methode von ItemsControl für jedes Element in der Auflistung aufzurufen, an die gebunden ist.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 das 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 ItemTemplate wird, wenn festgelegt ist.Note that this property is ignored if ItemTemplate is set.

Bietet ItemsControl 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 ItemContainerStyle die-Eigenschaft ItemContainerStyleSelector oder die-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 ListBoxsind ListBoxItem die generierten Container-Steuerelemente ComboBoxfür die-Steuerelemente, ComboBoxItem und sind-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 GroupStyle die GroupStyleSelector -Eigenschaft oder die-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: StaticResource, oder. DynamicResourceOne of the following: StaticResource, or DynamicResource. Wenn die Stile selbst keine Verweise auf potenzielle Lauf Zeit Verweise enthalten, wie z. b. Systemressourcen StaticResource oder Benutzereinstellungen, wird in der Regel ein 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:Keyein 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