DataViewBase.DetailHeaderContent Property

Gets or sets the detail section’s header content.

Namespace: DevExpress.Xpf.Grid

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

Declaration

C#

public object DetailHeaderContent { get; set; }

VB.NET

Public Property DetailHeaderContent As Object

Property Value

Type	Description
Object	An object representing the detail section’s header content.

Remarks

Details display header sections when the DetailDescriptorBase.ShowHeader option is enabled. When using a DataControlDetailDescriptor, you can specify the header section content via the detail Grid View’s DataViewBase.DetailHeaderContent. If no template has been assigned to the DetailDescriptorBase.HeaderContentTemplate, then the header will display the textual representation of the assigned content object. If you specify a template, then the DataViewBase.DetailHeaderContent will define the DataContext for the template.

The following image shows a detail header section’s default representation (when no template has been assigned).

The DetailHeaderContent property also specifies the string representation of the Detail section within the Group Panel, Filter Panel and detail tab headers. For ContentDetailDescriptor objects, use the ContentDetailDescriptor.HeaderContent property. The following image shows these two properties in action.

Example

The following example shows how to create a new grid and set up Master-Detail data representation in code. When setting up a Master-Detail hierarchy, a detail grid and a custom detail section are placed within a tabbed container. So, the following Detail Descriptor types are used: DataControlDetailDescriptor, ContentDetailDescriptor, and TabViewDetailDescriptor.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/create-details-with-a-grid-and-custom-content-and-put-them-in-a-tabbed-container-e4031.

MainWindow.xaml

<dxg:GridControl Grid.Row="0" Name="gridControl1" AutoGenerateColumns="AddNew" >
    <dxg:GridControl.View>
        <dxg:TableView DetailHeaderContent="Employees" AutoWidth="True" ShowGroupPanel="False"  />
    </dxg:GridControl.View>
    <dxg:GridControl.DetailDescriptor>
        <dxg:TabViewDetailDescriptor>
            <dxg:TabViewDetailDescriptor.DetailDescriptors>
                <dxg:DataControlDetailDescriptor ItemsSourcePath="Orders">
                    <dxg:DataControlDetailDescriptor.DataControl>
                        <dxg:GridControl AutoGenerateColumns="AddNew">
                            <dxg:GridControl.View>
                                <dxg:TableView DetailHeaderContent="Orders" AutoWidth="True" ShowGroupPanel="False" />
                            </dxg:GridControl.View>
                        </dxg:GridControl>
                    </dxg:DataControlDetailDescriptor.DataControl>
                </dxg:DataControlDetailDescriptor>
                <dxg:ContentDetailDescriptor ContentTemplate="{StaticResource EmployeeNotes}" HeaderContent="Notes">
                </dxg:ContentDetailDescriptor>
            </dxg:TabViewDetailDescriptor.DetailDescriptors>
        </dxg:TabViewDetailDescriptor>
    </dxg:GridControl.DetailDescriptor>
</dxg:GridControl>

MainWindow.xaml.cs

private void Button_Click(object sender, RoutedEventArgs e)
{
    GridControl newGrid = CreateGrid();
    AddDetailsToGrid(newGrid);
    Grid.SetRow(newGrid, 2);
    mainGrid.Children.Add(newGrid);
}
private GridControl CreateGrid()
{
    GridControl newGrid = new GridControl();
    newGrid.AutoGenerateColumns = AutoGenerateColumnsMode.AddNew;
    newGrid.View = new TableView();
    (newGrid.View as TableView).AutoWidth = true;
    (newGrid.View as TableView).ShowGroupPanel = false;
    newGrid.View.DetailHeaderContent = "Employees";
    newGrid.ItemsSource = Employees;
    return newGrid;
}

private void AddDetailsToGrid(GridControl grid)
{
    DataControlDetailDescriptor dataControlDetail = new DataControlDetailDescriptor();
    dataControlDetail.ItemsSourcePath = "Orders";

    GridControl detailGrid = new GridControl();
    dataControlDetail.DataControl = detailGrid;
    detailGrid.AutoGenerateColumns = AutoGenerateColumnsMode.AddNew;
    detailGrid.View.DetailHeaderContent = "Orders";
    (detailGrid.View as TableView).ShowGroupPanel = false;

    ContentDetailDescriptor contentDetail = new ContentDetailDescriptor();
    contentDetail.ContentTemplate = (DataTemplate)FindResource("EmployeeNotes");
    contentDetail.HeaderContent = "Notes";

    TabViewDetailDescriptor tabDetail = new TabViewDetailDescriptor();
    tabDetail.DetailDescriptors.Add(dataControlDetail);
    tabDetail.DetailDescriptors.Add(contentDetail);

    grid.DetailDescriptor = tabDetail;
}

MainWindow.xaml.vb

Private Sub Button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim newGrid As GridControl = CreateGrid()
    AddDetailsToGrid(newGrid)
    Grid.SetRow(newGrid, 2)
    mainGrid.Children.Add(newGrid)
End Sub
Private Function CreateGrid() As GridControl
    Dim newGrid As New GridControl()
    newGrid.AutoGenerateColumns = AutoGenerateColumnsMode.AddNew
    newGrid.View = New TableView()
    TryCast(newGrid.View, TableView).AutoWidth = True
    TryCast(newGrid.View, TableView).ShowGroupPanel = False
    newGrid.View.DetailHeaderContent = "Employees"
    newGrid.ItemsSource = Employees
    Return newGrid
End Function

Private Sub AddDetailsToGrid(ByVal grid As GridControl)
    Dim dataControlDetail As New DataControlDetailDescriptor()
    dataControlDetail.ItemsSourcePath = "Orders"

    Dim detailGrid As New GridControl()
    dataControlDetail.DataControl = detailGrid
    detailGrid.AutoGenerateColumns = AutoGenerateColumnsMode.AddNew
    detailGrid.View.DetailHeaderContent = "Orders"
    TryCast(detailGrid.View, TableView).ShowGroupPanel = False

    Dim contentDetail As New ContentDetailDescriptor()
    contentDetail.ContentTemplate = CType(FindResource("EmployeeNotes"), DataTemplate)
    contentDetail.HeaderContent = "Notes"

    Dim tabDetail As New TabViewDetailDescriptor()
    tabDetail.DetailDescriptors.Add(dataControlDetail)
    tabDetail.DetailDescriptors.Add(contentDetail)

    grid.DetailDescriptor = tabDetail
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DetailHeaderContent property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

create-details-with-a-grid-and-custom-content-and-put-them-in-a-tabbed-container-e4031/CS/WpfApplication18/MainWindow.xaml#L22

<dxg:GridControl.View>
    <dxg:TableView DetailHeaderContent="Employees" AutoWidth="True" ShowGroupPanel="False"  />
</dxg:GridControl.View>

displaying-chart-control-in-grid-details-e4042/CS/WpfApplication19/MainWindow.xaml#L68

<dxg:GridControl.View>
    <dxg:TableView AutoWidth="True" DetailHeaderContent="DataControlDetailDescriptor" ShowGroupPanel="False" />
</dxg:GridControl.View>

how-to-create-a-gridcontrol-detail-with-custom-content-t237942/VB/WpfApplication18/MainWindow.xaml#L18

<dxg:GridControl.View>
    <dxg:TableView DetailHeaderContent="Employees" AutoWidth="True" ShowGroupPanel="False"  />
</dxg:GridControl.View>

how-to-print-a-detail-grid-with-a-header-t166273/CS/PrintingDetailHeaderExample/MainWindow.xaml#L33

<dxg:GridControl.View>
    <dxg:TableView ShowGroupPanel="False" DetailHeaderContent="Test Header">
        <dxg:TableView.PrintHeaderTemplate>

VB.NET

create-details-with-a-grid-and-custom-content-and-put-them-in-a-tabbed-container-e4031/VB/WpfApplication18/MainWindow.xaml.vb#L44

TryCast(newGrid.View, TableView).ShowGroupPanel = False
newGrid.View.DetailHeaderContent = "Employees"
newGrid.ItemsSource = Employees

displaying-chart-control-in-grid-details-e4042/VB/WpfApplication19/MainWindow.xaml.vb#L79

detailGrid.View = New TableView()
TryCast(detailGrid.View, TableView).DetailHeaderContent = "DataControlDetailDescriptor"
TryCast(detailGrid.View, TableView).ShowGroupPanel = False

how-to-create-a-gridcontrol-detail-with-custom-content-t237942/VB/WpfApplication18/MainWindow.xaml.vb#L44

TryCast(newGrid.View, TableView).ShowGroupPanel = False
newGrid.View.DetailHeaderContent = "Employees"
newGrid.ItemsSource = Employees