Skip to main content
All docs

Parameters Panel

  • 3 minutes to read

The Parameters panel allows you to specify parameter values in a report’s Print Preview.

Use the Parameters panel to specify parameter values

Submit Parameter Values

When you open a report’s Print Preview, the Parameters panel displays default parameter values and descriptions.

Parameters panel, "Waiting for parameter values" message

Specify parameter values and click Submit to generate the report’s Print Preview. Set the report’s RequestParameters property to false to display a report document for the default parameter values when you open the Print Preview.

Reset Parameter Values to Defaults

Click the Reset button to reset parameter values to defaults.

Reset parameter values to defaults

Hide the Parameters Panel

To remove the Parameters panel from a report’s Print Preview, disable the Visible option for all report parameters in the Report Parameters Editor.

Hide a parameter from the Parameters panel

When you hide the Parameters panel, the report’s Print Preview is generated with the default parameter values.

Customize the Parameters Panel

You can unite report parameters into expandable groups, place parameters side-by-side, add separators, and more.

Default panel Customized panel
Default panel Customized panel

Use the Report Parameters Editor

Right-click the Parameters node in the Field List and select Edit Parameters.

Invoke the Report Parameters Editor from the Field List

This action invokes the Report Parameters Editor.

The Report Parameters Editor

Use the menu on the left to create and customize parameters, groups, and separators.

Customize a Parameter

Specify the Label orientation property to choose the position of a parameter label relative to an editor.

The Report Parameters Editor - Specify label orientation

Label orientation = Horizontal (Default) Label orientation = Vertical
orientation = Horizontal (Default) orientation = Vertical

Create and Customize a Group

Click the Add group button to create a new group.

The Report Parameters Editor - Create a new group

Use the Up and Down buttons to change the order of parameters and groups, and place parameters inside or outside a group.

The Report Parameters Editor - Set up elements order

You can also drag-and-drop parameters and groups inside the menu to achieve the same result.

The Report Parameters Editor - Drag-and-drop elements in the menu

To customize a group, select it and use its editors on the right to set up the group appearance. The following example unites the customerName and companyName parameters into a group called Select a customer.

The Report Parameters Editor - Group customization options

Default panel Panel with a group
Default panel Panel with a group

Besides a title, you can also specify the following properties to customize the group appearance:

Orientation = Vertical (Default) Orientation = Horizontal
orientation = Vertical (Default) orientation = Horizontal
Show expand/collapse button = false (Default) Show expand/collapse button = true
showExpandButton = false (Default) showExpandButton = true
Expanded = true (Default) Expanded = false
expanded = true (Default) expanded = false
Show title = true (Default) Show title = false
titleVisible = true (Default) titleVisible = false
Show borders = true (Default) Show borders = false
borderVisible = true (Default) borderVisible = false

Add a Separator

Click the Add separator button to create a separator.

The Report Parameters Editor - Create a separator

Similar to parameters and groups, you can use the Up and Down buttons or drag-and-drop separators inside the menu to specify the location for these separators relative to other elements.

The Report Parameters Editor - Specify a location for a separator

The example below shows the Parameters panel with a separator between the Company Name and Customer Name parameters.

Default panel Panel with a separator between parameters
Default panel Customized panel

Customize the Parameters Panel in Code

View Example: Reporting for WinForms - Customize the Parameters Panel

View Example: Reporting for ASP.NET Core - Customize the Parameters Panel

Refer to the ParameterPanelFluentBuilder class description for more information.

Implement a Custom Parameter Editor

The following image shows default editors for supported parameter types:

Default editors for supported parameter types

You can also implement a custom parameter editor. Refer to the following topics for details: