HeaderedItemsControl.HeaderTemplateSelector Eigenschaft

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

Eigenschaftswert

Eine Datenvorlagenauswahl.A data template selector. Die Standardeinstellung ist null.The default is null.

Attribute

Hinweise

In der Regel erstellen Sie DataTemplateSelector einen, wenn Sie mehr als DataTemplate einen für denselben Objekttyp haben, und Sie möchten eine eigene Logik bereitstellen DataTemplate , um eine für die Anwendung basierend auf den Eigenschaften der einzelnen Datenobjekte auszuwählen.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 DataTemplateim festlegen können, wenn Sie über Objekte mit unterschiedlichen 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 eines DataTrigger -oder-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 sowohl die HeaderTemplateSelector -Eigenschaft HeaderTemplate als auch die-Eigenschaft 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 SelectTemplate praktische außer Kraft Setzung 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: StaticResource, oder. DynamicResourceOne of the following: StaticResource, or DynamicResource. Siehe XAML-Ressourcen.See XAML Resources.

DataTemplateSelectorClassKeyDataTemplateSelectorClassKey
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 SelectTemplate praktische außer Kraft Setzung 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 eine Instanz der DataTemplateSelector Klasse auch Programm gesteuert 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

Gilt für: