Skip to main content
All docs
V25.2
  • 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.2.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 PreviewEditingFieldChanged 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.DesignerCustomization = {
        onPreviewEditingFieldChanged: function(s, e) {
            if ((e.Field.id() === "UnitsInStock") && (e.NewValue > 100))
                e.NewValue = e.OldValue;
        }
    }
    
    See Also