XRControl.Visible Property

Gets or sets a value indicating whether or not the report control is displayed in a document.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

[DefaultValue(true)]
[SRCategory(ReportStringId.CatBehavior)]
[XRLocalizable(true)]
public virtual bool Visible { get; set; }

VB.NET

<SRCategory(ReportStringId.CatBehavior)>
<DefaultValue(True)>
<XRLocalizable(True)>
Public Overridable Property Visible As Boolean

Property Value

Type	Default	Description
Boolean	true	true, if the control is displayed; otherwise, false.

Remarks

When the Visible property is set to false, the document will contain an empty area corresponding to the control’s dimensions (irrespective of the XRControl.CanShrink property value). An exception is the XRSubreport control that becomes suppressed in a document when its CanShrink setting is enabled.

To precisely maintain the position and visibility of report elements in a document, consider creating reports programmatically.

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_how-to-detect-that-the-new-page-is-being-created-in-the-beforeprint-event-handler-e1915/CS/NewPageStarted/XtraReport1.cs#L16

if (PrintingSystem.Document.PageCount != pageCount) {
    lblNewPage.Visible = true;
    pageCount = PrintingSystem.Document.PageCount;

reporting-winforms-best-fit-table-column-width/CS/ReportHelper/ReportHelper.cs#L70

var result = new List<KeyValuePair<XRTable, List<XRTable>>>();
IEnumerable<XRTable> allTables = xtraReport.AllControls<XRTable>().Where(t => t.Visible);
foreach(var table in allTables) {

Reporting_how-to-create-a-label-in-the-pageheader-band-when-a-field-is-dragged-from-the-t457241/CS/T457241/Form1.cs#L72

headerBand.HeightF = 0;
headerBand.Visible = true;
DesignTool.AddToContainer(host, headerBand);

VB.NET

Reporting_how-to-detect-that-the-new-page-is-being-created-in-the-beforeprint-event-handler-e1915/VB/NewPageStarted/XtraReport1.vb#L18

If PrintingSystem.Document.PageCount <> pageCount Then
    lblNewPage.Visible = True
    pageCount = PrintingSystem.Document.PageCount

reporting-winforms-best-fit-table-column-width/VB/ReportHelper/ReportHelper.vb#L69

Dim result = New List(Of KeyValuePair(Of XRTable, List(Of XRTable)))()
Dim allTables As IEnumerable(Of XRTable) = xtraReport.AllControls(Of XRTable)().Where(Function(t) t.Visible)
For Each table In allTables

Reporting_how-to-create-a-label-in-the-pageheader-band-when-a-field-is-dragged-from-the-t457241/VB/T457241/Form1.vb#L80

headerBand.HeightF = 0
headerBand.Visible = True
DesignTool.AddToContainer(host, headerBand)