# Custom Parameters View

Design custom parameters view to be displayed in the parameter panel on preview, in ActiveReports WebDesigner.

## Content



The Parameters View/Panel can be designed in Report Designer using the exclusive set of controls to create and define parameters and prompts quickly. The controls include input controls like text editor, number editor, heading, and plain text; range editors like date range and date-time range; and list and dropdown editors.

On previewing the report, the customized parameters view/panel is shown in the Parameter Panel of the viewer on preview.

### Design a Parameters View

The reference to AcmeStore.rdlx will be taken.

1.  Go to the **Parameters** tab at the top.<br />
2.  Create the custom parameters view for the report by clicking the **Generate View** button in the toolbar or clicking the **Generate** button in the center of the designer<br />If the report already has pre-defined report parameters, a default parameters layout is generated in the design area from these parameters. You can then build the parameters view from the default view or simply create a fresh parameter view using the controls available in the parameters designer.<br />
3.  Drag-drop the controls from the toolbox that will be used for inputting parameters.<br />
4.  Set the properties of each of the control such as Binding, Type, depending on the function each of the control.<br />
5.  Add buttons to preview the report based on selected parameters, reset the parameter selection to default, and clear the selection.

### Preview the Report with Custom Parameters View

The controls provide an intuitive user experience with customization possibilities. Following is the list of controls available for designing a parameters view.

*   **Text Editor**: For single-line parameter of the String type.
*   **Number Editor**: For parameters of integer or float type. Set the control's type as **Up-down Editor** for increasing or decreasing at specified steps, or as **Slider** to be able to slide the value of the parameter.
*   **Number Range Editor**: For a parameter range of integer or float type. You need to specify the range in **From** and **To** fields in **Binding**.
*   **Boolean Editor**: For parameters with the Boolean value. The Boolean editor can be a Toggle, Checkbox, or a Radio button. As you change the type of the Boolean editor, the options accordingly can be filled in.
*   **DateTime Editor**: For parameters with date and date-time values.
*   **Date Range Editor**: For parameters with a date field. Specify the start date and end date in the **From** and **To** fields in **Binding**.<br />You can also add custom ranges manually using the **Ranges** property (Add > Edit) or select ranges from the pre-defined options in a dropdown menu (Current, Last, Next, ToDate, and LastToDate) for intervals (specified via the **Unit** property: Year, Quarter, Month, Week, etc.) Using the **View Mode** property, you can set the calendar's initial view to Default, Days, Months, or Years.
*   **DateTime Range Editor**: For parameters with a range of dates with an explicit starting and ending time.<br />You can also add custom ranges manually using the **Ranges** property (Add > Edit) or select ranges from the pre-defined options in a dropdown menu (Current, Last, Next, ToDate, and LastToDate) for intervals (specified via the **Unit** property: Year, Quarter, Month, Week, etc.)
*   **Multivalue Editor**: For multi-value parameters whose values are required to be entered manually. It appears with a list of multiple values in the drop-down with the search box.
*   **Dropdown Editor**: A list of fields in the parameter appears in the drop-down with a search box. Single or multiple values can be selected depending on whether the Multi Value property is enabled or not.
*   **List Editor**: Fields bound to parameter appears as a list, with checkboxes to select the field.
*   **Tree View**: For hierarchical parameter. Select the Tree View type as **List** or **Dropdown**.
*   **Heading**: For static text, e.g., entering a heading with a choice of colors for error or warning.
*   **Plain Text**: For static text, eg., entering single or multiline text.
*   **Button**: To perform actions on the preview screen, select **Preview** to preview report based on the selected parameters, **Reset** to reset the parameter selection to default, and **Clear** to clear the selection, on preview window.

Use **Free Form/Stack** switch to see how parameters will look in the preview window.

When the 'Free Form' layout type is on, the view matches the current parameter panel on the viewer's sidebar. The order of parameters can be changed by dragging the controls. You can also change the location and size of the controls.

When the 'Stack' layout is on, the view arranges the controls vertically. The order of parameters can be changed by dragging the controls. Also, you can select the 'Highlight Required' option to highlight any errors while designing the parameter panel.<br />

<br />For information on the WebDesigner API and its integration into applications, see [WebDesigner Application](/activereportsnet/docs/v19.2/developers/create-applications/web-designer-application).