HeaderedItemsControl.Header Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft das Element ab, mit dem das Steuerelement bezeichnet wird, oder legt dieses 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

Object

Ein Objekt, das das HeaderedItemsControl bezeichnet. Der Standardwert ist null. Ein Header kann eine Zeichenfolge oder ein UIElement sein.

Attribute

BindableAttribute

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 in der der HeaderTemplate HeaderedItemsControl. Weitere Informationen zum Anzeigen der ContentPresenter HeaderAnzeige finden Sie unter ContentPresenter.

Verwendung von XAML-Attributen

<object Header="headerString"/>  

Verwendung von XAML-Eigenschaftenelementen

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

XAML-Werte

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

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	HeaderProperty
Metadateneigenschaften auf true festgelegt	Keine