Skip to main content

BandedGridOptionsCustomization.ShowBandsInCustomizationForm Property

Gets or sets a value specifying whether hidden bands can be shown within the Customization Form.

Namespace: DevExpress.XtraGrid.Views.BandedGrid

Assembly: DevExpress.XtraGrid.v24.1.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool ShowBandsInCustomizationForm { get; set; }

Property Value

Type Default Description
Boolean true

true if hidden bands can be shown within the Customization Form; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to ShowBandsInCustomizationForm
BandedGridView
.OptionsCustomization .ShowBandsInCustomizationForm

Remarks

By default, the Customization Form contains the Columns and Bands pages. They are used to display headers of hidden columns and bands respectively. The image below shows an example.

BandedGridOptionsCustomization_ShowBandsInCustomizationForm

The ShowBandsInCustomizationForm option specifies whether headers of hidden bands can be displayed within the Customization Form. If it is disabled, the Bands page is not displayed. Thus, end-users cannot drag band headers to the Customization Form to hide bands.

Note that each band has the OptionsBand.ShowInCustomizationForm option. If it is disabled for a band, hiding this band doesn’t result in displaying its header within the Customization Form. End-users, however, can drag band headers to the Customization Form to hide bands. Note that band headers will disappear when dropped onto the Customization Form.

See Also