HeaderedItemsControl.Header Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia element, który etykietuje kontrolkę.

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

Wartość właściwości

Object

Obiekt, który etykietuje obiekt HeaderedItemsControl. Wartość domyślna to null. Nagłówek może być ciągiem lub .UIElement

Atrybuty

BindableAttribute

Przykłady

W poniższym przykładzie pokazano, jak utworzyć szablon nagłówka i użyć go do określenia wyglądu nagłówka.

<!--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}" />

Uwagi

Header Ponieważ właściwość jest typu Object, nie ma żadnych ograniczeń dotyczących tego, co można umieścić w obiekcie Header. Wartość jest wyświetlana Header przez element ContentPresenter, który znajduje się w obiekcie .HeaderedItemsControlHeaderTemplate Aby uzyskać więcej informacji na temat sposobu wyświetlania elementu ContentPresenter Header, zobacz ContentPresenter.

Użycie atrybutu języka XAML

<object Header="headerString"/>  

Użycie elementu właściwości języka XAML

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

Wartości XAML

headerString
Ciąg do użycia jako nagłówek.

Informacje dotyczące właściwości zależności

Pole identyfikatora	HeaderProperty
Właściwości metadanych ustawione na true	Brak