GridViewSettings Class

An object that exposes properties for controlling the features supported by the GridView. The GridView object is used by XamDataGrid and XamDataPresenter

Syntax

Visual Basic

'Declaration
 
Public Class GridViewSettings 
   Inherits GridViewSettingsBase

C#

public class GridViewSettings : GridViewSettingsBase 

Remarks

By manipulating properties on the GridViewSettings object you can control how the GridViewPanelFlat or GridViewPanelNested arranges items.

The properties exposed by the GridViewSettings object are:

• GridViewSettingsBase.AllowLastRecordScrollToTop - Returns/sets a value that determines whether the last record can scroll all the way to the top.
• HeightInInfiniteContainers - Returns/sets a value that is used as default for the height of the control implementing the view when used in a container with infinite height available.
• Orientation - Determines the orientation of records.
• WidthInInfiniteContainers - Returns/sets a value that is used as default for the width of the control implementing the view when used in a container with infinite width available.
• UseNestedPanels - Determines whether a single GridViewPanelFlat is used to arrange records or whether multiple GridViewPanelNested panels are used.

Refer to the documentation contained within for a complete list of the properties supported by this class and the functionality enabled by each property.

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

XAML

    <!-- 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>

Visual Basic

' 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

C#

// 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