HeaderedItemsControl.Header Eigenschaft

Definition

Ruft das Element ab, mit dem das Steuerelement bezeichnet wird, oder legt dieses fest.Gets or sets the item that labels the control.

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

Eigenschaftswert

Ein Objekt, das das HeaderedItemsControl bezeichnet.An object that labels the HeaderedItemsControl. Die Standardeinstellung ist null.The default is null. Ein Header kann eine Zeichenfolge oder ein UIElement sein.A header can be a string or a UIElement.

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

Da die Header -Eigenschaft vom Typ Objectist, gibt es keine Einschränkungen, was Sie in die Headereinfügen können.Because the Header property is of type Object, there are no restrictions on what you can put in the Header. Der Header wird von einem ContentPresenterangezeigt, der HeaderedItemsControlsich in der HeaderTemplate von befindet.The Header is displayed by a ContentPresenter, which is in the HeaderTemplate of the HeaderedItemsControl. Weitere Informationen ContentPresenter zum Anzeigen des Headerfinden ContentPresenterSie unter.For more information about how the ContentPresenter displays the Header, see ContentPresenter.

Verwendung von XAML-AttributenXAML Attribute Usage

<object Header="headerString"/>  

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

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

XAML-WerteXAML Values

headerStringheaderString
Die Zeichenfolge, die als Überschrift verwendet werden soll.The string to use as a heading.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für: