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

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