FieldSettings Property (FieldLayout)

Holds the default settings for all fields in the Fields collection.

Syntax

Visual Basic

'Declaration
 
Public Property FieldSettings As FieldSettings

C#

public FieldSettings FieldSettings {get; set;}

Remarks

FieldSettings are exposed via the following 3 properties:

• DataPresenterBase's FieldSettings - settings specified here become the default for all Fields in every FieldLayout.
• FieldLayout's FieldSettings - settings specified here become the default for all Fields in this FieldLayout's Fields collection.
• Field's Settings - settings specified here apply to only this one specific Field.

Refer to the Fields topic in the Developer's Guide for an explanation of fields.

Refer to the Field Settings topic in the Developer's Guide for an explanation of the FieldSettings object.

Refer to the Theory of Operation topic in the Developer's Guide for an explanation of how this object is used.

Example

The following sample demonstrates how to initialize the FieldSettings for a specific FieldLayout. In this example, the CellClickAction is changed so that clicking upon a cell with result in the containing DataRecord being selected.

XAML

<igDP:XamDataGrid BindToSampleData="True">

    <igDP:XamDataGrid.FieldLayouts>

        <!-- define a field layout that will match the data -->
        <igDP:FieldLayout>

            <!-- initialize settings for the fields in this specific field layout -->
            <igDP:FieldLayout.FieldSettings>
                <igDP:FieldSettings CellClickAction="SelectRecord"/>
            </igDP:FieldLayout.FieldSettings>

            <!-- define the fields for the field layout -->
            <igDP:FieldLayout.Fields>
                <igDP:Field Name="name" />
                <igDP:Field Name="department" />
                <igDP:Field Name="salary" />
                <igDP:Field Name="email" />
            </igDP:FieldLayout.Fields>

        </igDP:FieldLayout>
    </igDP:XamDataGrid.FieldLayouts>

</igDP:XamDataGrid>

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