GridBand.Visible Property

Gets or sets whether the band is visible.

Namespace: DevExpress.XtraGrid.Views.BandedGrid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

[DXCategory("Appearance")]
[DefaultValue(true)]
[XtraSerializableProperty]
[XtraSerializablePropertyId(3)]
public virtual bool Visible { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(True)>
<XtraSerializableProperty>
<XtraSerializablePropertyId(3)>
Public Overridable Property Visible As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true if the band is visible; otherwise, false.

Remarks

If the Visible property is set to true, the band may be visible within the View. The GridBand.VisibleIndex property specifies its visual position within the owning band.

If set to false, the band is not displayed within the View. In this case, its header is displayed within the Customization Form if the band’s OptionsBand.ShowInCustomizationForm option and the View’s BandedGridOptionsCustomization.ShowBandsInCustomizationForm options are enabled. Note that the hidden band’s child bands’ and columns’ headers are not displayed within the Customization Form.

Note that a band is invisible regardless of its GridBand.Visible property value if its parent band’s GridBand.Visible property is set to false. The GridBand.ReallyVisible property can be used to determine the band’s actual visibility.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference 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#

how-to-display-bands-and-columns-in-the-same-tree-list-in-the-customization-form-e3723/CS/CustomDescendants/TreeListBandedCustomizationForm.cs#L48

GridBand band = e.Node[0] as GridBand;
if (band != null && !band.Visible) DrawNodeElementAsColumn(e);

VB.NET

how-to-display-bands-and-columns-in-the-same-tree-list-in-the-customization-form-e3723/VB/CustomDescendants/TreeListBandedCustomizationForm.vb#L52

Dim band As GridBand = TryCast(e.Node(0), GridBand)
If band IsNot Nothing AndAlso (Not band.Visible) Then
    DrawNodeElementAsColumn(e)