Back to Devexpress

DataControlDetailDescriptor Class

wpf-devexpress-dot-xpf-dot-grid-62fdee32.md

latest6.1 KB
Original Source

DataControlDetailDescriptor Class

Represents a detail that displays a grid control and natively integrates with the master grid.

Namespace : DevExpress.Xpf.Grid

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

NuGet Package : DevExpress.Wpf.Grid.Core

Declaration

csharp
public class DataControlDetailDescriptor :
    DetailDescriptorBase,
    IDataControlOwner
vb
Public Class DataControlDetailDescriptor
    Inherits DetailDescriptorBase
    Implements IDataControlOwner

Remarks

When setting up master-detail hierarchy, the Detail may display either another grid or custom controls. If you choose to display another grid, you will need to use the DataControlDetailDescriptor object in one of the following ways:

View Example: Create a Master-Detail Grid

The following are the main members that you will need to work with when using a DataControlDetailDescriptor :

MemberDescription
DataControlDetailDescriptor.ItemsSourcePathGets or sets the detail grid’s data binding by specifying the path relative to the master grid’s records.
DataControlDetailDescriptor.DataControlGets or sets the GridControl that displays detail data.
DataViewBase.DetailHeaderContentGets or sets the detail section’s header content.

If you are using the DataControlDetailDescriptor to display a Detail, the following integration features become available:

  • Detail synchronization
  • Single scrollbar for both master and detail views
  • Common group panel displayed at the top of the master view
  • Common filter panel displayed at the bottom of the master view

Note

The DataControlDetailDescriptor does not support UI Automation.

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

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.

wpf-data-grid-display-different-details-based-on-master-row-data/CS/WpfApp30/MainWindow.xaml#L19

xml
<dxg:DetailDescriptorSelector.DefaultValue>
    <dxg:DataControlDetailDescriptor ItemsSourcePath="CompletedActions">
        <dxg:GridControl AutoGenerateColumns="AddNew">

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

xml
<dxg:TabViewDetailDescriptor>
    <dxg:DataControlDetailDescriptor ItemsSourcePath="Orders">
        <dxg:DataControlDetailDescriptor.DataControl>

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

xml
<dxg:ContentDetailDescriptor ContentTemplate="{StaticResource ContentDetail}" HeaderContent="ContentDetailDescriptor"/>
<dxg:DataControlDetailDescriptor ContentTemplate="{StaticResource ContentDetail}" ItemsSourcePath="Orders">
    <dxg:GridControl AutoGenerateColumns="AddNew">

wpf-data-grid-expand-and-collapse-master-rows/CS/WpfApplication21/MainWindow.xaml#L17

xml
<dxg:GridControl.DetailDescriptor>
    <dxg:DataControlDetailDescriptor ItemsSourcePath="Orders">
        <dxg:DataControlDetailDescriptor.DataControl>

Inheritance

Object DispatcherObject DependencyObject ContentElement FrameworkContentElement DXFrameworkContentElement DetailDescriptorBase DataControlDetailDescriptor

See Also

DataControlDetailDescriptor Members

ContentDetailDescriptor

TabViewDetailDescriptor

DetailDescriptor

Display Chart Control in Grid Details

DevExpress.Xpf.Grid Namespace