Skip to main content
All docs
V25.1
  • DxReportDesignerCallbacks.PreviewEditingFieldChanged Property

    Specifies the JavaScript function that handles the Web Report Designer’s PreviewEditingFieldChanged client-side event.

    Namespace: DevExpress.Blazor.Reporting

    Assembly: DevExpress.Blazor.Reporting.v25.1.JSBasedControls.Common.dll

    NuGet Package: DevExpress.Blazor.Reporting.JSBasedControls.Common

    Declaration

    [Parameter]
    public string PreviewEditingFieldChanged { get; set; }

    Property Value

    Type Description
    String

    The name of a JavaScript function used to handle the PreviewEditingFieldChanged event.

    Remarks

    If you enable content editing in a preview, the Preview allows users to edit the content of specific reporting controls. For more information on this feature, refer to the following help topic: Content Editing in Print Preview.

    The EditingFieldChanged event allows you to respond to field value changes (for instance, to validate input data or format a value).

    The handler function receives two parameters - the first parameter is the client-side Preview (the event sender) and the second parameter is an object with the following properties and methods:

    • Field
      An editable field in which the value changes.

    • OldValue
      The field’s previous value.

    • NewValue
      The field’s new value.

    The following code reverts the editable field’s value if the new value does not meet the specified criteria:

    window.ReportingDesignerCustomization = {
        onPreviewEditingFieldChanged: function(s, e) {
            if ((e.Field.id() === "UnitsInStock") && (e.NewValue > 100))
                e.NewValue = e.OldValue;
        }
    }
    
    See Also