Parameter.Visible Property

Specifies whether a parameter editor is visible in the Parameters panel.

Namespace: DevExpress.XtraReports.Parameters

Assembly: DevExpress.Printing.v24.2.Core.dll

Declaration

C#

[DefaultValue(true)]
public bool Visible { get; set; }

VB.NET

<DefaultValue(True)>
Public Property Visible As Boolean

Property Value

Type	Default	Description
Boolean	true	true to show a parameter editor; otherwise, false.

Remarks

All hidden parameters are submitted to a report with default values. You can also submit default values for all report parameters (visible and hidden) when you open a report Preview. For this, disable the report’s RequestParameters property.

Example

The following example hides an editor of the Company parameter.

Visible = true (Default)	Visible = false

C#

using DevExpress.XtraReports.Parameters;
// ...
report.Parameters["company"].Visible = false;

VB.NET

Imports DevExpress.XtraReports.Parameters
' ...
report.Parameters("company").Visible = False

You can also specify an expression for the Visible property to show/hide a parameter editor based on a value of another parameter.

C#

using DevExpress.XtraReports.Parameters;
// ...
using DevExpress.XtraReports.Expressions;
// ...
report.Parameters["company"].ExpressionBindings.Add(
    new BasicExpressionBinding() {
        PropertyName = "Visible",
        Expression = "!IsNullOrEmpty(?customer)",
    }
);

VB.NET

Imports DevExpress.XtraReports.Parameters
' ...
Imports DevExpress.XtraReports.Expressions
' ...
report.Parameters("company").ExpressionBindings.Add(
    New BasicExpressionBinding() With {
        .PropertyName = "Visible",
        .Expression = "!IsNullOrEmpty(?customer)"
    }
)

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Visible property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

reporting-wpf-create-drill-down-report-document-preview-control/CS/dxWPFApp/MainWindow.xaml.cs#L154

Parameter categoryNameParameter = new DevExpress.XtraReports.Parameters.Parameter();
categoryNameParameter.Visible = false;
categoryNameParameter.Name = "catNameParam";

reporting-winforms-add-report-parameters/CS/ReportParameterExample/Form1.cs#L23

param1.Description = "Category: ";
param1.Visible = true;

reporting-winforms-salary-reports/CS/SalaryReports/MainForm.cs#L24

report.Parameters["paramEmpName"].Value = string.Empty;
report.Parameters["paramEmpName"].Visible = false;
e.Control = new DocumentViewerUserControl() { Report = report };

reporting-winforms-parameter-static-list/CS/ParameterLookUpWindowsFormsApplication/Form1.cs#L24

parameter1.Type = typeof(System.Int32);
parameter1.Visible = true;
parameter1.Description = "Category Name: ";

reporting-winforms-parameter-multivalue/CS/Program.cs#L45

// values as defaults.
parameter1.Visible = true;
parameter1.SelectAllValues = true;

VB.NET

reporting-wpf-create-drill-down-report-document-preview-control/VB/dxWPFApp/MainWindow.xaml.vb#L158

Dim categoryNameParameter As Parameter = New DevExpress.XtraReports.Parameters.Parameter()
categoryNameParameter.Visible = False
categoryNameParameter.Name = "catNameParam"

reporting-winforms-add-report-parameters/VB/ReportParameterExample/Form1.vb#L24

param1.Description = "Category: "
param1.Visible = True
' Add the parameter to the report.

reporting-winforms-salary-reports/VB/SalaryReports/MainForm.vb#L20

report.Parameters("paramEmpName").Value = String.Empty
report.Parameters("paramEmpName").Visible = False
e.Control = New DocumentViewerUserControl() With {.Report = report}

reporting-winforms-parameter-static-list/VB/ParameterLookUpWindowsFormsApplication/Form1.vb#L25

parameter1.Type = GetType(Integer)
parameter1.Visible = True
parameter1.Description = "Category Name: "

reporting-winforms-parameter-multivalue/VB/Program.vb#L49

' values as defaults.
parameter1.Visible = True
parameter1.SelectAllValues = True