Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

AllowFieldFixing Enumeration

Indicates whether the FieldItem.FixedLocation may be changed by the end user and if so, to which edges the field may be fixed.
Syntax
'Declaration
 
Public Enum AllowFieldFixing 
   Inherits System.Enum
public enum AllowFieldFixing : System.Enum
Members
MemberDescription
DefaultThe default is resolved to 'No'
FarThe field may be fixed to the far edge. In a horizontal layout, the field elements will be displayed on bottom when fixed and in a vertical layout, the field elements will be displayed on right when fixed.
NearThe field may be fixed to the near edge. In a horizontal layout, the field elements will be displayed on top when fixed and in a vertical layout, the field elements will be displayed on left when fixed.
NearOrFarThe field may be fixed to the near or far edge.
NoThe field’s fixed state may not be changed.
Example
The following sample demonstrates how to enable fixing for fields. It uses the FixedLocation to determine the initial fixed position of a specific field and prevents one of them from being unfixed.

        <igDP:XamDataGrid BindToSampleData="True">
            <igDP:XamDataGrid.FieldSettings>
                <!-- Enable fixing for all fields -->
                <igDP:FieldSettings AllowFixing="NearOrFar" />
            </igDP:XamDataGrid.FieldSettings>
            <igDP:XamDataGrid.FieldLayouts>
                <igDP:FieldLayout>
                    <igDP:FieldLayout.Fields>
                        <!-- Initialize some fields so they start out fixed -->
                        <igDP:Field Name="name" FixedLocation="FixedToNearEdge" />
                        
                        <!-- fix this to the right and prevent the user from changing it -->
                        <igDP:Field Name="department" FixedLocation="FixedToFarEdge">
                            <igDP:Field.Settings>
                                <igDP:FieldSettings AllowFixing="No" />
                            </igDP:Field.Settings>
                        </igDP:Field>
                    </igDP:FieldLayout.Fields>
                </igDP:FieldLayout>
            </igDP:XamDataGrid.FieldLayouts>
        </igDP:XamDataGrid>        <igDP:XamDataGrid BindToSampleData="True">
            <igDP:XamDataGrid.FieldSettings>
                <!-- Enable fixing for all fields -->
                <igDP:FieldSettings AllowFixing="NearOrFar" />
            </igDP:XamDataGrid.FieldSettings>

            <!-- The FixedFieldUIType determines what ui is presented 
                to the end user to change the fixed location of a field -->
            <igDP:XamDataGrid.FieldLayoutSettings>
                <igDP:FieldLayoutSettings FixedFieldUIType="ButtonAndSplitter" />
            </igDP:XamDataGrid.FieldLayoutSettings>
            
            <igDP:XamDataGrid.FieldLayouts>
                <igDP:FieldLayout>
                    <igDP:FieldLayout.Fields>
                        <!-- Initialize some fields so they start out fixed -->
                        <igDP:Field Name="name" FixedLocation="FixedToNearEdge" />
                        
                        <!-- fix this to the right and prevent the user from changing it -->
                        <igDP:Field Name="department" FixedLocation="FixedToFarEdge">
                            <igDP:Field.Settings>
                                <igDP:FieldSettings AllowFixing="No" />
                            </igDP:Field.Settings>
                        </igDP:Field>
                    </igDP:FieldLayout.Fields>
                </igDP:FieldLayout>
            </igDP:XamDataGrid.FieldLayouts>
        </igDP:XamDataGrid>
Imports Infragistics.Windows.DataPresenter

    Private Sub InitializeDP(ByVal dp As DataPresenterBase)
        ' FixedFieldUIType determine the elements that are displayed in the ui
        ' that the end user may use to change the state of the fixedlocation
        ' of the fields that allow fixing
        dp.FieldLayoutSettings.FixedFieldUIType = FixedFieldUIType.ButtonAndSplitter

        ' AllowFixing determines whether the fixed state may be changed by the 
        ' user. note, even if fixedfielduitype is none the fixed state could 
        ' be changed by dragging a field into or out of a fixed area
        dp.FieldSettings.AllowFixing = AllowFieldFixing.NearOrFar

        ' just use sample data for the demo
        dp.BindToSampleData = True

        Dim fl As FieldLayout = New FieldLayout()

        ' the following field should start off as fixed to the near edge. since 
        ' we have enabled fixing, its fixed state can be changed by the end user
        Dim fldName As Field = New Field()
        fldName.Name = "name"
        fldName.FixedLocation = FixedFieldLocation.FixedToNearEdge
        fl.Fields.Add(fldName)

        ' the following field should start off as fixed to the far edge but 
        ' using the AllowFixing for this field's settings we can prevent the 
        ' end user from being able to change its state
        Dim fldDept As Field = New Field()
        fldDept.Name = "department"
        fldDept.FixedLocation = FixedFieldLocation.FixedToFarEdge
        fldDept.Settings.AllowFixing = AllowFieldFixing.No
        fl.Fields.Add(fldDept)

        dp.FieldLayouts.Add(fl)
    End Sub
using Infragistics.Windows.DataPresenter;

    private void InitializeDP(DataPresenterBase dp)
    {
        // FixedFieldUIType determine the elements that are displayed in the ui
        // that the end user may use to change the state of the fixedlocation
        // of the fields that allow fixing
        dp.FieldLayoutSettings.FixedFieldUIType = FixedFieldUIType.ButtonAndSplitter;

        // AllowFixing determines whether the fixed state may be changed by the 
        // user. note, even if fixedfielduitype is none the fixed state could 
        // be changed by dragging a field into or out of a fixed area
        dp.FieldSettings.AllowFixing = AllowFieldFixing.NearOrFar;

        // just use sample data for the demo
        dp.BindToSampleData = true;

        FieldLayout fl = new FieldLayout();

        // the following field should start off as fixed to the near edge. since 
        // we have enabled fixing, its fixed state can be changed by the end user
        Field fldName = new Field();
        fldName.Name = "name";
        fldName.FixedLocation = FixedFieldLocation.FixedToNearEdge;
        fl.Fields.Add(fldName);

        // the following field should start off as fixed to the far edge but 
        // using the AllowFixing for this field's settings we can prevent the 
        // end user from being able to change its state
        Field fldDept = new Field();
        fldDept.Name = "department";
        fldDept.FixedLocation = FixedFieldLocation.FixedToFarEdge;
        fldDept.Settings.AllowFixing = AllowFieldFixing.No;
        fl.Fields.Add(fldDept);

        dp.FieldLayouts.Add(fl);
    }
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