BaseColumn.HeaderCaption Property

Gets the column header’s caption. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v20.2.Core.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Grid.Core, DevExpress.Wpf.Grid.Core

Declaration

C#

public object HeaderCaption { get; }

VB.NET

Public ReadOnly Property HeaderCaption As Object

Property Value

Type	Description
Object	An object that represents the column header’s caption.

Remarks

The main part of a header’s content is a caption. You can change this caption and add different elements to a header content.

• Customize Header Caption
• Specify Custom Content
• Specify Header Content Style

Customize Header Caption

The image below shows a grid column with changed header caption:

Specify the BaseColumn.Header property to change the column header’s caption. If the BaseColumn.Header property isn’t specified, a column header’s caption is specified by the ColumnBase.FieldName property. Camel-case field names are split with spaces, e.g., the header for the “CategoryName” field name is “Category Name”. The following code sample demonstrates how to use this property:

XAML

<dxg:GridColumn FieldName="CategoryName" Header="Category" HorizontalHeaderContentAlignment="Center"></dxg:GridColumn>

You can obtain the actual column header’s caption by using the HeaderCaption property.

Tip

Use the BaseColumn.HorizontalHeaderContentAlignment property to specify the column header’s content alignment.

Specify Custom Content

The image below shows a grid column whose header contains a button:

Specify the BaseColumn.HeaderTemplate property to customize header content for an individual column. You can specify a common template applied to all columns displayed in the current GridControl’s view by using the DataViewBase.ColumnHeaderTemplate. The data context (binding source) for these templates is the HeaderCaption property.

The following code sample demonstrates how to change a column header’s content:

XAML

<dxg:GridColumn FieldName="CategoryName">
   <dxg:GridColumn.HeaderTemplate>
      <DataTemplate>
         <StackPanel>
            <TextBlock Text="{Binding}"></TextBlock>
            <Button Content="Button" Margin="0,5,0,0"></Button>
         </StackPanel>
      </DataTemplate>
   </dxg:GridColumn.HeaderTemplate>
</dxg:GridColumn>

See the How to: Display an Image within a Column Header example to learn how to add an image to column header content using BaseColumn.HeaderTemplate.

If you have more than one template that can be used to render header content, specify the BaseColumn.HeaderTemplateSelector property to implement custom logic for choosing the required template. Use the BaseColumn.ActualHeaderTemplateSelector property to obtain the actual template selector.

Specify Header Content Style

The image below shows a grid column whose header caption is red and has an increased font size:

Specify the ColumnBase.ColumnHeaderContentStyle property to change a column header content’s appearance. Use the DataViewBase.ColumnHeaderContentStyle property to specify a common column header content’s style applied to all columns displayed in the current GridControl’s view. The target element for these styles is ContentControl class.

The following code sample demonstrates how to change a header caption’s color and increase the font size:

XAML

<dxg:GridColumn FieldName="CategoryName">               
   <dxg:GridColumn.ColumnHeaderContentStyle>
      <Style TargetType="{x:Type ContentControl}">
         <Setter Property="FontSize" Value="15" />
         <Setter Property="Foreground" Value="Red" />                        
      </Style>
   </dxg:GridColumn.ColumnHeaderContentStyle>                
</dxg:GridColumn>

Use the ColumnBase.ActualColumnHeaderContentStyle property to obtain a column header content’s style which is currently used by a column.