Skip to main content

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