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

Advanced Banded Grid Views - Column Layouts

This topic describes settings that allow you to customize a column layout within Advanced Banded Grid Views.

Expanded Banded Column Layouts

Advanced Banded Grid Views allow you to arrange column headers across rows. You can also stretch column headers vertically so that they occupy more than one row. Note that the layout of data cells will match your layout of column headers.

The column header's position is identified by the BandedGridColumn.ColIndex and BandedGridColumn.RowIndex properties. Note that the BandedGridColumn.ColIndex property is read-only and thus cannot be used for layout customization. To change a column header's position at runtime, use the AdvBandedGridView.SetColumnPosition method. This method accepts the column, its target column and row indexes as parameters. To move a column between bands, use a column's BandedGridColumn.OwnerBand property.

At design time, the column headers layout can be customized using drag and drop. This can be done directly within the grid control or within the designer's Band Designer page. Please refer to the Customizing the Band Layout topic for details on using this designer page.


As for Banded Grid Views, you can move columns between bands only when the BandedGridOptionsCustomization.AllowChangeColumnParent option is enabled. Otherwise, columns can only be moved within their owning band.

The image below illustrates the BandedGridColumn.ColIndex and BandedGridColumn.RowIndex properties.

Column headers occupy several rows in the following cases:


The height of a single column header row is specified by the View's GridView.ColumnPanelRowHeight property.

The image below illustrates the relation between the BandedGridColumn.RowCount and BandedGridColumn.AutoFillDown properties.

Expanded Customizing a Banded Column Layout via Code

The code below creates the layout shown in the images above. First, it assigns columns to appropriate bands using the BandedGridColumn.OwnerBand property. Next, columns are arranged within their bands using the View's AdvBandedGridView.SetColumnPosition method.

Expanded See Also

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