HeaderedItemsControl.Header Property

Definition

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

Property Value

Object

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

Attributes

Examples

En el ejemplo siguiente se 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}" />

Remarks

Dado que la propiedad Header es de tipo Object, no hay ninguna restricción sobre lo que se puede colocar en 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 una ContentPresenter, que se encuentra en el HeaderTemplate del HeaderedItemsControl.The Header is displayed by a ContentPresenter, which is in the HeaderTemplate of the HeaderedItemsControl. Para obtener más información sobre cómo el ContentPresenter muestra el Header, vea 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 va a usar como encabezado.The string to use as a heading.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field HeaderProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true NoneNone

Applies to