MultiDetailDescriptor.DetailDescriptors Property

Provides access to Detail Descriptors to be displayed by this multi-detail container.

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 DetailDescriptorCollection DetailDescriptors { get; }

VB.NET

Public ReadOnly Property DetailDescriptors As DetailDescriptorCollection

Property Value

Type	Description
DetailDescriptorCollection	A DetailDescriptorCollection object containing Detail Descriptors to be displayed by this multi-detail container.

Remarks

When you need a GridControl to display multiple details, you need to assign a MultiDetailDescriptor descendant to the GridControl.DetailDescriptor property. This can be a TabViewDetailDescriptor object or another descendant. Once the required object is assigned, you need to populate it’s DetailDescriptors collection with Detail Descriptors that you want to display.

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.

View Example

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 DetailDescriptors 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.

XAML

wpf-data-grid-display-chart-control-in-grid-details/CS/WpfApplication19/MainWindow.xaml#L61

<dxg:TabViewDetailDescriptor>
    <dxg:TabViewDetailDescriptor.DetailDescriptors>
        <dxg:ContentDetailDescriptor ContentTemplate="{StaticResource ContentDetail}" HeaderContent="ContentDetailDescriptor">

wpf-data-grid-display-detail-content-in-tabs/CS/WpfApplication18/MainWindow.xaml#L26

<dxg:TabViewDetailDescriptor>
    <dxg:TabViewDetailDescriptor.DetailDescriptors>
        <dxg:DataControlDetailDescriptor ItemsSourcePath="Orders">