Freigeben über


HeaderedItemsControl.Header Eigenschaft

Definition

Ruft das Element ab, das das Steuerelement beschriftt, oder legt es fest.

public:
 property System::Object ^ Header { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
public object Header { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Header : obj with get, set
Public Property Header As Object

Eigenschaftswert

Ein Objekt, das die Beschriftung angibt HeaderedItemsControl. Der Standardwert lautet null. Eine Kopfzeile kann eine Zeichenfolge oder eine .UIElement

Attribute

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Kopfzeilenvorlage erstellen und verwenden, um die Darstellung der Kopfzeile anzugeben.

<!--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

Da die Header Eigenschaft vom Typ Objectist, gibt es keine Einschränkungen für das, was Sie in die HeaderDatei einfügen können. Dies Header wird durch ein ContentPresenter, das sich im HeaderTemplate Bereich der HeaderedItemsControl. Weitere Informationen dazu, wie das ContentPresenter angezeigt wird Header, finden Sie unter ContentPresenter.

Verwendung von XAML-Attributen

<object Header="headerString"/>

XAML-Eigenschaftselementverwendung

<object>
  <object.Header>
    <UIElement />
  </object.Header>
</object>

XAML-Werte

headerString
Die Zeichenfolge, die als Überschrift verwendet werden soll.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld HeaderProperty
Auf Metadateneigenschaften festgelegt true Nichts

Gilt für: