XPObjectSpace.InstantFeedbackMappingMode Property

Specifies what properties should be mapped on a grid in the InstantFeedback or InstantFeedbackView mode.

Namespace: DevExpress.ExpressApp.Xpo

Assembly: DevExpress.ExpressApp.Xpo.v24.1.dll

NuGet Package: DevExpress.ExpressApp.Xpo

Declaration

C#

public XPInstantFeedbackSourceMappingMode InstantFeedbackMappingMode { get; set; }

VB.NET

Public Property InstantFeedbackMappingMode As XPInstantFeedbackSourceMappingMode

Property Value

Type	Description
XPInstantFeedbackSourceMappingMode	The XPInstantFeedbackSourceMappingMode enumeration value that specifies a properties mapping mode in the InstantFeedback or InstantFeedbackView mode.

Available values:

Name	Description
AllProperties	All properties should be mapped on a grid.
RequiredProperties	Only visible properties should be mapped on a grid.

Remarks

By default, in the InstantFeedback and InstantFeedbackView modes, all properties values are calculated at once regardless of grid columns settings. If you need to calculate only visible columns values, set the InstantFeedbackMappingMode property to XPInstantFeedbackSourceMappingMode.RequiredProperties as demonstrated below:

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Xpo;
//...
public class MyController : WindowController {
    public MyController() {
        this.TargetWindowType = WindowType.Main;
    }
    protected override void OnActivated() {
        base.OnActivated();
        Application.ListViewCreating += Application_ListViewCreating;
    }
    private void Application_ListViewCreating(object sender, ListViewCreatingEventArgs e) {
        if((e.CollectionSource.DataAccessMode == CollectionSourceDataAccessMode.InstantFeedback) && 
          (e.ObjectSpace is DevExpress.ExpressApp.Xpo.XPObjectSpace) && (e.ViewID == "Customer_ListView")) {
            ((XPObjectSpace)e.ObjectSpace).InstantFeedbackMappingMode =
XPInstantFeedbackSourceMappingMode.RequiredProperties;
        }
    }
    protected override void OnDeactivated() {
        Application.ListViewCreating -= Application_ListViewCreating;
        base.OnDeactivated();
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Xpo
'...
Public Class MyController
    Inherits WindowController
    Public Sub New()
        Me.TargetWindowType = WindowType.Main
    End Sub
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        AddHandler Application.ListViewCreating, AddressOf Application_ListViewCreating
    End Sub
    Private Sub Application_ListViewCreating(ByVal sender As Object, ByVal e As ListViewCreatingEventArgs)
        If (e.CollectionSource.DataAccessMode = CollectionSourceDataAccessMode.InstantFeedback) AndAlso _
(TypeOf e.ObjectSpace Is XPObjectSpace) AndAlso _
(e.ViewID = "Customer_ListView") Then
            CType(e.ObjectSpace, DevExpress.ExpressApp.Xpo.XPObjectSpace).InstantFeedbackMappingMode = _
XPInstantFeedbackSourceMappingMode.RequiredProperties
        End If
    End Sub
    Protected Overrides Sub OnDeactivated()
        RemoveHandler Application.ListViewCreating, AddressOf Application_ListViewCreating
        MyBase.OnDeactivated()
    End Sub
End Class

To map other columns which are not visible in the grid, add them to a collection of displayed options as described in the CollectionSourceBase.DisplayableProperties topic.

If you want to specify what properties should be mapped on a grid for all Object Spaces, use the XPObjectSpaceProvider.InstantFeedbackMappingMode property of an Object Space Provider.