InitializeParametersDialog Event

In This Topic

Fired before the control displays the Report Parameters dialog.

Syntax

Visual Basic
C#

'Declaration
 
Public Event InitializeParametersDialog As DialogEventHandler

public event DialogEventHandler InitializeParametersDialog

Remarks

Reports that have a PARAMETERS clause in their RecordSource property show a dialog where the user can enter report parameters.

This event fires before the dialog is displayed and allows you to customize the dialog by changing its caption, font, colors, etc.

You can also use this event to inspect and modify parameter values using the DialogEventArgs.Parameters collection.

Finally, you can use the DialogEventArgs.ShowDialog property to prevent the component from showing the parameters dialog.

Example

The code below uses the InitializeParametersDialog event to modify the values of the report parameters and suppress the display of the parameter dialog.

private void c1Report1_InitializeParametersDialog(object sender, 
         C1.C1Preview.C1Report.DialogEventArgs e)
{
  // change parameter values
  ReportParameterCollection p = e.Parameters;
  p["TheString"].Value = "east";
  p["TheNumber"].Value = 12;
  p["TheDate"].Value   = DateTime.Now;
  p["TheBool"].Value   = true;
  
  // don't show dialog
  e.ShowDialog = false;
}

Reference

C1Report Class
C1Report Members