HeaderedItemsControl.HeaderTemplateSelector Property

Definition

Ruft das Objekt ab, das die benutzerdefinierte Auswahllogik für eine Vorlage bereitstellt, mit der der Header für die einzelnen Elemente angezeigt wird, oder legt dieses fest.Gets or sets the object that provides custom selection logic for a template used to display the header of each item.

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

Property Value

DataTemplateSelector

Eine Datenvorlagenauswahl.A data template selector. Der Standardwert lautet null.The default is null.

Attributes

Remarks

In der Regel erstellen Sie eine DataTemplateSelector, wenn mehrere DataTemplate für denselben Objekttyp vorhanden sind und Sie Ihre eigene Logik zum Auswählen eines DataTemplate bereitstellen möchten, das auf der Grundlage der Eigenschaften der einzelnen Datenobjekte angewendet werden soll.Typically, you create a DataTemplateSelector when you have more than one DataTemplate for the same type of objects and you want to supply your own logic to choose a DataTemplate to apply based on the properties of each data object. Beachten Sie, dass Sie die DataType-Eigenschaft für die DataTemplatefestlegen können, wenn Sie über Objekte unterschiedlicher Typen verfügen.Note that if you have objects of different types you can set the DataType property on the DataTemplate. Wenn Sie dies tun, ist es nicht erforderlich, eine DataTemplateSelectorzu erstellen.If you do that, then there is no need to create a DataTemplateSelector. Wenn Sie über Objekte desselben Typs, aber mit unterschiedlichen Eigenschaften verfügen, können Sie auch die Verwendung einer DataTrigger oder eines Daten Konverters in Erwägung gezogen.Furthermore, if you have objects of the same type but with different properties, you can also consider using a DataTrigger or a data converter. Weitere Informationen finden Sie unter Übersicht über Datenvorlagen.For more information, see Data Templating Overview.

Erstellen Sie eine-Klasse, die von DataTemplateSelector erbt, und überschreiben Sie die SelectTemplate-Methode, um eine Vorlagen Auswahl zu erstellen.To create a template selector, create a class that inherits from DataTemplateSelector and override the SelectTemplate method. Nachdem die Klasse definiert wurde, können Sie der Template Selector-Eigenschaft des Elements eine Instanz der-Klasse zuweisen.After your class is defined, you can assign an instance of the class to the template selector property of your element.

Wenn die Eigenschaften HeaderTemplateSelector und HeaderTemplate festgelegt sind, wird die Vorlagen Auswahl Eigenschaft ignoriert.If both the HeaderTemplateSelector and the HeaderTemplate properties are set, the template selector property is ignored.

Verwendung von XAML-AttributenXAML Attribute Usage

<object HeaderTemplateSelector="{ResourceExtension DataTemplateSelectorClassKey}"/>  

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

<object>  
  <object.HeaderTemplateSelector>  
    <MyDataTemplateSelectorImplementation .../>  
  </object.HeaderTemplateSelector>  
</object>  

XAML-WerteXAML Values

MydatatemplateselectorimplementationMyDataTemplateSelectorImplementation
Eine von DataTemplateSelector abgeleitete Klasse, die eine praktische SelectTemplate Überschreibung implementiert.A class derived from DataTemplateSelector that implements a practical SelectTemplate override. Weitere Informationen zum Zuordnen Ihrer benutzerdefinierten Klasse finden Sie unter XAML-Namespaces und Namespace Zuordnung für WPF-XAML.For information about how to map your custom class, see XAML Namespaces and Namespace Mapping for WPF XAML.

ResourceextensionResourceExtension
Eines der folgenden: StaticResourceoder DynamicResource.One of the following: StaticResource, or DynamicResource. Siehe XAML-Ressourcen.See XAML Resources.

DataTemplateSelector ClassKeyDataTemplateSelectorClassKey
Der Schlüssel, der die angeforderte Selektor-Implementierung identifiziert.The key that identifies the selector implementation being requested. Der Schlüssel verweist auf eine abgeleitete Klasse, die eine praktische SelectTemplate Überschreibung implementiert.The key refers to a derived class that implements a practical SelectTemplate override. Weitere Informationen zum Zuordnen Ihrer benutzerdefinierten Klasse finden Sie unter XAML-Namespaces und Namespace Zuordnung für WPF-XAML.For information about how to map your custom class, see XAML Namespaces and Namespace Mapping for WPF XAML. Sie können auch Programm gesteuert eine Instanz Ihrer DataTemplateSelector-Klasse als Ressource zu einem Ressourcen Wörterbuch hinzufügen.You can also programmatically add an instance of your DataTemplateSelector class as a resource to a resource dictionary.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Applies to