Skip to main content

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