Skip to main content
All docs
V25.1
  • DxDocumentViewerCallbacks.EditingFieldChanged Property

    Specifies the handler for the EditingFieldChanged client-side event that allows you to respond to a field value change.

    Namespace: DevExpress.Blazor.Reporting

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

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

    Declaration

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

    Property Value

    Type Description
    String

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

    Remarks

    If you enable content editing in a preview, the Document Viewer 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 a field value change (for instance, to validate input data or format the value).

    The handler function receives two parameters - the first parameter is the client-side Document Viewer (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.ReportingViewerCustomization = {
        onEditingFieldChanged: function(s, e) {
            if ((e.Field.id() === "UnitsInStock") && (e.NewValue > 100))
                e.NewValue = e.OldValue;
        }
    }
    
    See Also