GridViewColumn.HeaderTemplate Property

public:
 property System::Windows::DataTemplate ^ HeaderTemplate { System::Windows::DataTemplate ^ get(); void set(System::Windows::DataTemplate ^ value); };

public System.Windows.DataTemplate HeaderTemplate { get; set; }

member this.HeaderTemplate : System.Windows.DataTemplate with get, set

Public Property HeaderTemplate As DataTemplate

Property Value

A DataTemplate to use to display the column header. The default is null.

Examples

The following example shows how to specify a template to use to display the header of a GridViewColumn.

<DataTemplate x:Key="myHeaderTemplate">
  <DockPanel>
    <CheckBox/>
    <TextBlock FontSize="16" Foreground="DarkBlue">
      <TextBlock.Text>
        <Binding/>
      </TextBlock.Text>
    </TextBlock>
  </DockPanel>
</DataTemplate>

<GridViewColumn Header="Month" Width="80"
      HeaderContainerStyle="{StaticResource myHeaderStyle}"
      HeaderTemplate="{StaticResource myHeaderTemplate}"
      DisplayMemberBinding="{Binding Path=Month}"/>

Remarks

If both the HeaderTemplateSelector property and the HeaderTemplate property are set, the HeaderTemplate property takes precedence.

After a HeaderTemplate or ColumnHeaderTemplate is specified for a GridViewColumn, it cannot be changed.

You can also define the display of a column header by specifying a ControlTemplate as part of a GridViewColumn.HeaderContainerStyle.

Properties that define the content, layout, and style of a column header are found on many related classes, and some of these properties have functionality that is similar or the same. For more information, see GridView Column Header Styles and Templates Overview.

XAML Attribute Usage

<object HeaderTemplate="{ResourceExtension TemplateResourceKey}"/>  

XAML Property Element Usage

XAML Values

ResourceExtension
One of the following: StaticResource, or DynamicResource. See XAML Resources.

TemplateResourceKey
The key that identifies the template being requested. The key refers to an existing resource in a ResourceDictionary.

Dependency Property Information

Applies to

See also

• HeaderTemplateSelector
• ColumnHeaderTemplate
• HeaderContainerStyle