Version

UseNestedPanels Property

Determines how items panels are used to display hierarchical data.
Syntax
'Declaration
 
Public Property UseNestedPanels As Boolean
public bool UseNestedPanels {get; set;}
Remarks

Note: setting this property to 'False' is more performant with deep nested structures (e.g. with hierarchical data and/or multiple groupby fields) since it uses a single GridViewPanelFlat to arrange RecordPresenters. However, it can not make use of each RecordPresenter's RecordPresenter.NestedContent and therefore will not pick up any chrome or animations relating to that nested content.

Example
The following example demonstrates how to initialize the ViewSettings of aXamDataGrid or a XamDataPresenter. In this example, the Orientation is set to Vertical and the UseNestedPanels property is set to 'True'.


    <!-- Setting UseNestedPanels to true on a XamDataGrid will
         cause nested content to become active. This will enable
         any chrome, animations and triggers relating to
         RecordPresenters' nested content.-->
    <igDP:XamDataGrid x:Name="xamDataGrid1">
        <igDP:XamDataGrid.ViewSettings>
            <igDP:GridViewSettings UseNestedPanels="True" Orientation="Vertical"/>
        </igDP:XamDataGrid.ViewSettings>
    </igDP:XamDataGrid>

    <!-- Here is how you would set UseNestedPanels properties
         on a XamDataPresenter.
         Note: the default value for UseNestedPanels is false and
               the default value for Orientation is Vertical.-->
    <igDP:XamDataPresenter x:Name="xamDataPresenter1">
        <igDP:XamDataPresenter.View>
            <igDP:GridView>
                <igDP:GridView.ViewSettings>
                    <igDP:GridViewSettings UseNestedPanels="True" Orientation="Vertical"/>
                </igDP:GridView.ViewSettings>
            </igDP:GridView>
        </igDP:XamDataPresenter.View>
    </igDP:XamDataPresenter>

' Setting UseNestedPanels to true on a XamDataGrid will
' cause nested content to become active. This will enable
' any chrome, animations and triggers relating to
' RecordPresenters' nested content.
Me.xamDataGrid1.ViewSettings.UseNestedPanels = True
Me.xamDataGrid1.ViewSettings.Orientation = Orientation.Vertical

' Here is how you would set ViewSettings properties
' on a XamDataPresenter.
' Note: the default value for UseNestedPanels is false and
'       the default value for Orientation is Vertical.
Dim gv As New Infragistics.Windows.DataPresenter.GridView
gv.ViewSettings.UseNestedPanels = True
gv.ViewSettings.Orientation = Orientation.Vertical
Me.xamDataPresenter1.View = gv
// Setting UseNestedPanels to true on a XamDataGrid will
     // cause nested content to become active. This will enable
     // any chrome, animations and triggers relating to
     // RecordPresenters' nested content.
     this.xamDataGrid1.ViewSettings.UseNestedPanels = true;
     this.xamDataGrid1.ViewSettings.Orientation = Orientation.Vertical;

     // Here is how you would set ViewSettings properties
     // on a XamDataPresenter.
     // Note: the default value for UseNestedPanels is false and
     //       the default value for Orientation is Vertical.
     Infragistics.Windows.DataPresenter.GridView gv 
         = new Infragistics.Windows.DataPresenter.GridView();
     gv.ViewSettings.UseNestedPanels = true;
     gv.ViewSettings.Orientation = Orientation.Vertical;
     this.xamDataPresenter1.View = gv;
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also