AllowRecordFixing Enumeration

Indicates whether the Record.FixedLocation may be changed by the end user and if so, to which edges the record may be fixed.

Syntax

Visual Basic

'Declaration
 
Public Enum AllowRecordFixing 
   Inherits System.Enum

C#

public enum AllowRecordFixing : System.Enum 

Members

Member	Description
Bottom	The record may be fixed to the bottom edge.
Default	The default is resolved to 'No'
No	The record’s fixed state may not be changed.
Top	The record may be fixed to the top edge.
TopOrBottom	The record may be fixed to the top or bottom edge.

Example

The following code shows how to set various properties relating to record fixing.

Visual Basic

Dim settings As FieldLayoutSettings = Me.xamDataGrid2.FieldLayoutSettings

' Allow fixing to the top or bottom of the display
'
' Note: fixing to the bottom is only supported at the root level so
'       any child records or records inside groups can only be
'       fixed to the top
settings.AllowRecordFixing = AllowRecordFixing.TopOrBottom

' Specify a limit to the number of records that can be fixed.
' Once the limit has been reached the record that was fixed first 
' will be bumped off the fixed list when a new record is fixed (FIFO).
'
' Note: This limit applies independently to the top and bottom so
'       that in Me case there could be up to 3 records fixed to
'       the top and 3 records fixed to the bottom at the same time.
settings.FixedRecordLimit = 3

' By setting FixedRecordSortOrder to 'FixOrder' the records will 
' be ordered such that the record that was fixed last will be
' closest to the scrollable records i.e. the last record fixed to
' the top will be at the bottom of the top fixed records. The order
' is reversed for bottom fixed records.
'
' Note: This order is maintained until the user performs a sort 
'       operation or the RefreshSort methd is called.
settings.FixedRecordSortOrder = FixedRecordSortOrder.FixOrder

' Setting FixedRecordUIType to 'Button' will display a FixedRecordButton
' in the RecordSelector of a DataRecord
settings.FixedRecordUIType = FixedRecordUIType.Button

C#

FieldLayoutSettings settings = this.xamDataGrid2.FieldLayoutSettings;

// Allow fixing to the top or bottom of the display
//
// Note: fixing to the bottom is only supported at the root level so
//       any child records or records inside groups can only be
//       fixed to the top
settings.AllowRecordFixing = AllowRecordFixing.TopOrBottom;

// Specify a limit to the number of records that can be fixed.
// Once the limit has been reached the record that was fixed first 
// will be bumped off the fixed list when a new record is fixed (FIFO).
//
// Note: This limit applies independently to the top and bottom so
//       that in this case there could be up to 3 records fixed to
//       the top and 3 records fixed to the bottom at the same time.
settings.FixedRecordLimit = 3;

// By setting FixedRecordSortOrder to 'FixOrder' the records will 
// be ordered such that the record that was fixed last will be
// closest to the scrollable records i.e. the last record fixed to
// the top will be at the bottom of the top fixed records. The order
// is reversed for bottom fixed records.
//
// Note: This order is maintained until the user performs a sort 
//       operation or the RefreshSort methd is called.
settings.FixedRecordSortOrder = FixedRecordSortOrder.FixOrder;

// Setting FixedRecordUIType to 'Button' will display a FixedRecordButton
// in the RecordSelector of a DataRecord
settings.FixedRecordUIType = FixedRecordUIType.Button;

XAML

    <!-- Set various properties on FieldLayoutSettings relating to record fixing.
     Note: fixing to the bottom is only supported at the root level so
           any child records or records inside groups can only be
           fixed to the top -->
    <igDP:XamDataGrid x:Name="xamDataGrid2">
        <igDP:XamDataGrid.FieldLayoutSettings>
            <igDP:FieldLayoutSettings 
                AllowRecordFixing="TopOrBottom"
                FixedRecordLimit="3"
                FixedRecordSortOrder="FixOrder"
                FixedRecordUIType="Button"/>
        </igDP:XamDataGrid.FieldLayoutSettings>
    </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