Back to Devexpress

Controlling the Visibility of Bands and Columns

vcl-170062-expressquantumtreelist-end-user-capabilities-controlling-the-visibility-of-bands-and-columns.md

latest3.9 KB
Original Source

Controlling the Visibility of Bands and Columns

  • Jul 29, 2024
  • 2 minutes to read

The following operations allow end-users to change the visibility of bands:

|

Action

|

Effect

| | --- | --- | |

Clicking items within the Quick Band Customization dropdown.

|

Shows or hides corresponding bands.

| |

Dragging band headers to the customization form.

|

Hides corresponding bands.

End-users can invoke the customization form via the column header context menu.

| |

Dragging band headers and dropping them outside the band header panel.

|

Hides corresponding bands.

This action can be performed when the OptionsCustomizing.BandHiding property is set to True or the customization form is displayed.

| |

Dragging band headers from the customization form and dropping them within the band header panel.

|

Shows corresponding bands.

|

Note

Use the TreeList control’s OptionsCustomizing.BandCustomizing and OptionsCustomizing.BandMoving properties to prohibit end-users from moving bands or customizing them using the customization form. Use a band’s Options.Customizing and Options.Moving properties to prohibit moving or customizing individual bands. To respond to end-user changes made to the visibility of bands, handle the TreeList control’s OnBandPosChanged event.

The following operations allow end-users to change the visibility of columns:

|

Action

|

Effect

| | --- | --- | |

Clicking items within the Quick Column Customization dropdown.

|

Shows or hides corresponding columns.

| |

Dragging column headers to the customization form.

|

Hides corresponding columns.

| |

Dragging column headers and dropping them outside the column header panel.

|

Hides corresponding columns.

This action can be performed when the OptionsCustomizing.ColumnHiding property is set to True or the customization form is displayed.

| |

Dragging column headers from the customization form and dropping them within the column header panel.

|

Shows corresponding columns.

| |

Clicking the ‘Remove this Column’ item within the column header context menu.

|

Hides the column located under the mouse pointer.

|

Note

Use the TreeList control’s OptionsCustomizing.ColumnCustomizing and OptionsCustomizing.ColumnMoving properties to prohibit end-users from moving columns or customizing them using the customization form. Use a column’s Options.Customizing and Options.Moving properties to prohibit moving or customizing individual columns. To respond to end-user changes made to the visibility of columns, handle the TreeList control’s OnColumnPosChanged event.