HeaderedItemsControl.Header HeaderedItemsControl.Header HeaderedItemsControl.Header HeaderedItemsControl.Header Property

Definición

Obtiene o establece el elemento que etiqueta el control.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

Valor de propiedad

Objeto que etiqueta el control HeaderedItemsControl.An object that labels the HeaderedItemsControl. De manera predeterminada, es null.The default is null. Un encabezado puede ser una cadena o un UIElement.A header can be a string or a UIElement.

Ejemplos

El ejemplo siguiente muestra cómo crear y usar una plantilla de encabezado para especificar la apariencia del encabezado.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}" />

Comentarios

Dado que el Header propiedad es de tipo Object, no hay ninguna restricción sobre lo que se puede colocar el Header.Because the Header property is of type Object, there are no restrictions on what you can put in the Header. El Header se muestra mediante un ContentPresenter, que se encuentra en el HeaderTemplate de la HeaderedItemsControl.The Header is displayed by a ContentPresenter, which is in the HeaderTemplate of the HeaderedItemsControl. Para obtener más información acerca de cómo los ContentPresenter muestra el Header, consulte ContentPresenter.For more information about how the ContentPresenter displays the Header, see ContentPresenter.

Uso de atributos XAMLXAML Attribute Usage

<object Header="headerString"/>  

Uso de elementos de propiedad XAMLXAML Property Element Usage

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

Valores XAMLXAML Values

headerStringheaderString
Cadena que se usará como un encabezado.The string to use as a heading.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field HeaderProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a