Log In
[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Grid View
   [Collapse]View Technology
    [Collapse]Banded Grid Views
      Banded Grid View
      Advanced Banded Grid View
      Bands Overview
      Advanced Banded Grid Views - Column Layouts
      Tutorial: Banded Grid View - API
      Tutorial: Banded Grid View - Basics
      Tutorial: Banded Grid View - Fixed Bands
      Tutorial: Banded Grid View - User Customization
      Customizing the Band Layout
      Fixed Bands
    [Expand]Card View
    [Expand]Layout View
    [Expand]Tile View
    [Expand]WinExplorer View
     View Hierarchy
   [Expand]Data Editing
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Bands Overview

Banded Grid View and Advanced Banded Grid View provide band elements that are used to organize columns in logical groups. This topic describes basic band functionality and provides information on their internal structure and access methods.

Expanded Online Video

Learn all the basics on our Banded and Advanced Banded Grid views.

Expanded Basic Band Functionality

Visually, a band is represented by a band header displayed above column headers. The image below shows a simple example. There are three bands each owning two columns.

Bands are not only used for display purposes. They can be dragged by end-users to re-order columns. This is extremely useful if you need a quick way to re-arrange columns while preserving their logical grouping. You can also anchor a band to the left or right View edge so that its child columns are always displayed and not scrolled horizontally. Please refer to the Fixed Bands topic for details on this feature.

By default, columns (and bands) can only move within their parent bands. This prevents end-users from breaking column grouping logic. However, you may want to allow columns to be moved between bands and this can be done by enabling the View's BandedGridOptionsCustomization.AllowChangeColumnParent option.

Banded Views allow you to create tree-like structures of bands, which means that bands located on higher rows possess bands located on lower levels. The number of band levels is unlimited.

The following image shows a simple hierarchical band structure. The Price Information band owns the Price and Units bands. Thus, end-users can drag the Price Information band to move all columns belonging to the Price and Units bands. When anchoring a band to a View edge, all its child band columns will be anchored as well.

By default, bands, as well as columns, are only allowed to move within their parent bands. Again, banded Views allow you to change this behavior by enabling the BandedGridOptionsCustomization.AllowChangeBandParent option.

Refer to the Customizing the Band Layout topic for detailed information on building band layouts.

Expanded How Bands are Organized Within a View

Each band is represented by a GridBand object. The object provides the band header display settings, properties controlling the band size, a child column collection, band behavior options, etc. Since bands can be visually organized in a tree, they also construct a tree at the object level. Bands located at the top hierarchy level are stored within the View's BandedGridView.Bands collection. Each GridBand object within that collection can have its own child band collection. This collection is exposed via a band's GridBand.Children property. Bands stored in such a collection are displayed at the second hierarchy level. They can also have their own children, etc. The image below illustrates this.

Expanded Accessing Bands

The following band access methods are available:

Expanded See Also

How would you rate this topic?​​​​​​​