Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.v24.2.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