The requested page is not available for the requested platform. You are viewing the content for Default platform.

XtraReport.ParametersRequestValueChanged Event

Occurs when the parameter values are changed in the Parameters UI.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll

Declaration

public event EventHandler<ParametersRequestValueChangedEventArgs> ParametersRequestValueChanged
Public Event ParametersRequestValueChanged As EventHandler(Of ParametersRequestValueChangedEventArgs)

Event Data

The ParametersRequestValueChanged event handler receives an argument of the ParametersRequestValueChangedEventArgs type. The following properties provide information specific to this event.

Property Description
ChangedParameterInfo Contains information about the parameter, which value was changed.
ParametersInformation Provides access to information about the requested parameters.
(Inherited from ParametersRequestEventArgs)

Remarks

The ParametersRequestValueChanged event fires only for Windows Forms applications.

Examples

This example demonstrates how to perform report parameter validation, and restore the previous parameter value if the validation fails (if the parameter value is greater than 10 or less than 0).

This is achieved by handling the report's XtraReport.ParametersRequestSubmit and XtraReport.ParametersRequestValueChanged events.

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using DevExpress.XtraReports.UI;
using DevExpress.XtraReports.Parameters;
// ...

namespace CancelSubmitParameters {
    public partial class XtraReport1 : XtraReport {
        int parameter;
        public XtraReport1() {
            InitializeComponent();
        }

        private void XtraReport1_ParametersRequestSubmit(object sender, 
            ParametersRequestEventArgs e) {
            if ((int)e.ParametersInformation[0].Parameter.Value > 10 || 
                (int)e.ParametersInformation[0].Parameter.Value < 0) {
                e.ParametersInformation[0].Parameter.Value = parameter;
                e.ParametersInformation[0].Editor.Text = parameter.ToString();
            }
        }

        private void XtraReport1_ParametersRequestValueChanged(object sender, 
            ParametersRequestValueChangedEventArgs e) {
            parameter = (int)e.ChangedParameterInfo.Parameter.Value;
        }

    }
}
See Also