HeaderedContentControl.Header HeaderedContentControl.Header HeaderedContentControl.Header HeaderedContentControl.Header Property

Definición

Obtiene o establece los datos usados por el encabezado de cada control.Gets or sets the data used for the header of each control.

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

Valor de propiedad

Objeto de encabezado.A header object. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo siguiente se crea un TabControl que contiene dos TabItem objetos que heredan de HeaderedContentControl.The following example creates a TabControl that contains two TabItem objects, which inherit from HeaderedContentControl. La primera TabItem tiene UIElement objetos como el contenido tanto en el Header y el Content: el Header está establecido en un StackPanel que contiene un Ellipse y un TextBlock; el Content se establece en un StackPanel que contiene un TextBlock y un Label.The first TabItem has UIElement objects as the content in both the Header and the Content: the Header is set to a StackPanel that contains an Ellipse and a TextBlock; the Content is set to a StackPanel that contains a TextBlock and a Label. El Header del segundo TabItem se establece en una cadena y el Content está establecido en un único TextBlock.The Header of the second TabItem is set to a string and the Content is set to a single TextBlock.

<TabControl>
  <TabItem>
    <TabItem.Header>
      <StackPanel Orientation="Horizontal">
        <Ellipse Width="10" Height="10" Fill="DarkGray"/>
        <TextBlock>Tab 1</TextBlock>
      </StackPanel>
    </TabItem.Header>
    <StackPanel>
      <TextBlock>Enter some text</TextBlock>
      <TextBox Name="textBox1" Width="50"/>
    </StackPanel>
  </TabItem>
  <TabItem Header="Tab 2">
    <!--Bind TextBlock.Text to the TextBox on the first
    TabItem.-->
    <TextBlock Text="{Binding ElementName=textBox1, Path=Text}"/>
  </TabItem>
</TabControl>

La siguiente ilustración muestra el TabControl creado por el ejemplo anterior.The following illustration shows the TabControl created by the previous example.

TabControlTabControl
TabControl con tipos diferentes de la propiedad de encabezadoTabControl with different types in the Header property

En el ejemplo siguiente se crean dos DataTemplate objetos que se va a especificar la apariencia de la Header y Content de la HeaderedContentControl.The following example creates two DataTemplate objects to specify the appearance of the Header and Content of the HeaderedContentControl.


<Style TargetType="HeaderedContentControl">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type HeaderedContentControl}">
        <StackPanel>
          <Grid>
            <Rectangle Stroke="{TemplateBinding Background}"/>
            <ContentPresenter ContentSource="Header"/>
          </Grid>
          <Grid>
            <Rectangle Fill="{TemplateBinding Background}"/>
            <ContentPresenter ContentSource="Content"/>
          </Grid>
        </StackPanel>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

<DataTemplate x:Key="titleText">
  <TextBlock Text="{Binding}" 
             Foreground="Green" 
             FontSize="16" 
             FontWeight="Normal"
             FontStyle="Italic" 
             TextWrapping="Wrap"/>
</DataTemplate>

<DataTemplate x:Key="contentText">
  <TextBlock Text="{Binding}"
             Foreground="Brown"
             FontSize="12"
             FontWeight="Normal"
             FontFamily="Arial Narrow" 
             TextWrapping="Wrap"/>
</DataTemplate>
<HeaderedContentControl Name="hcontCtrl" Background="Beige" 
                        HeaderTemplate="{StaticResource titleText}" 
                        ContentTemplate="{StaticResource contentText}"
                        Header="This is the header."
                        Content="This is the content."/>

Comentarios

Al igual que el Content propiedad de un ContentControl, el Header puede ser cualquier tipo.Like the Content property of a ContentControl, the Header can be any type. El HeaderedContentControl usa la misma lógica para mostrar el Header que se describe en ContentControl.Content.The HeaderedContentControl uses the same logic to display the Header that is described in ContentControl.Content.

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