Partilhar via


HeaderedItemsControl.Header Propriedade

Definição

Obtém ou define o item que rotula o controle.

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

Valor da propriedade

Object

Um objeto que rotula o HeaderedItemsControl. O padrão é null. Um cabeçalho pode ser uma cadeia de caracteres ou um UIElement.

Atributos

Exemplos

O exemplo a seguir mostra como criar e usar um modelo de cabeçalho para especificar a aparência do cabeçalho.

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

Comentários

Como a Header propriedade é do tipo Object, não há restrições sobre o que você pode colocar no Header. O Header é exibido por um ContentPresenter, que está no HeaderTemplate de HeaderedItemsControl. Para obter mais informações sobre como a ContentPresenter exibição é Headerexibida, consulte ContentPresenter.

Uso do Atributo XAML

<object Header="headerString"/>  

Uso do elemento propriedade XAML

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

Valores XAML

headerString
A cadeia de caracteres a ser usada como um título.

Informações da propriedade de dependência

Campo Identificador HeaderProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a