HeaderedItemsControl.HeaderTemplate Eigenschaft

Definition

Ruft die Vorlage ab, mit der der Inhalt des Steuerelementheaders angezeigt wird, oder legt diese fest.Gets or sets the template used to display the contents of the control's header.

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

Eigenschaftswert

Eine Datenvorlage, mit der der Header eines Steuerelements angezeigt wird.A data template used to display a control's header. Die Standardeinstellung ist null.The default is null.

Attribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie eine Header Vorlage erstellt und verwendet wird, um die Darstellung des Headers anzugeben.The following example shows how to create and use a header template to specify the appearance of the header.

<!--Define a control template for a HeaderedItemsControl-->
<Style TargetType="HeaderedItemsControl">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type HeaderedItemsControl}">
        <StackPanel>
          <Grid>
            <Rectangle Fill="{TemplateBinding Background}"/>
            <ContentPresenter ContentSource="Header"/>
          </Grid>
          <Grid>
            <Rectangle Stroke="{TemplateBinding BorderBrush}"/>
            <ItemsPresenter Margin="2,0,0,0"/>
          </Grid>
        </StackPanel>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>
<DataTemplate x:Key="RedHeaderTemplate">
  <TextBlock Text="{Binding}" Foreground="Red" 
             FontSize="16" FontWeight="Bold" 
             TextWrapping="Wrap"/>
</DataTemplate>

<DataTemplate x:Key="GreenItemTemplate">
  <TextBlock Text="{Binding}" Foreground="Green" 
             FontSize="14" FontWeight="Bold"></TextBlock>
</DataTemplate>
<!--Crate a HeaderedItemControl with a red header and green items.-->
<HeaderedItemsControl Name="hitemsCtrl"  
                      Background="DarkBlue" 
                      BorderBrush="Black"
                      Header="Header"
                      HeaderTemplate="{StaticResource RedHeaderTemplate}"
                      ItemsSource="{Binding Source={StaticResource Numbers}}"
                      ItemTemplate = "{StaticResource GreenItemTemplate}" />

Hinweise

Um die Überschrift von HeaderedItemsControlanzupassen, legen DataTemplateSie diese Eigenschaft auf fest.To customize the heading of the HeaderedItemsControl, set this property to a DataTemplate. Weitere Informationen zu Datenvorlagen finden Sie unter Übersicht über DatenVorlagen.For more information on data templates, see Data Templating Overview.

Verwendung von XAML-AttributenXAML Attribute Usage

<object HeaderTemplate="{ResourceExtension TemplateResourceKey}"/>  

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

XAML-WerteXAML Values

ResourceExtensionResourceExtension
Eines der folgenden: StaticResource, oder. DynamicResourceOne of the following: StaticResource, or DynamicResource. Siehe XAML-Ressourcen.See XAML Resources.

TemplateResourceKeyTemplateResourceKey
Der Schlüssel, der die angeforderte Vorlage identifiziert.The key that identifies the template being requested. Der Schlüssel verweist auf eine vorhandene Ressource in einer ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Hinweis

Die Syntax von Eigenschafts Elementen ist technisch möglich, wird jedoch nicht empfohlen.Property element syntax is technically possible, but not recommended. Weitere Informationen finden Sie unter Inline Stile und Vorlagen.See Inline Styles and Templates. Ein Bindungs Verweis, der oder verwendet, ist ebenfalls möglich, aber nicht üblich.A binding reference using or is also possible, but uncommon.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für:

Siehe auch