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

Customizing the Band Layout

This topic describes how to set up the band layout. First, it describes how to create a simple layout at design time, followed by the runtime equivalent.

Expanded Online Videos

Expanded Customizing the Band Layout at Design Time

You can reorder existing bands and columns, and modify their size and settings, directly on the form (without using the Grid Designer), as described in the On-form Band and Column Customization topic. However, if you wish to create new bands, invoke the Grid Designer's Bands Page. It allows you to change column and band layouts, add and delete bands, and customize band settings.

The animation below illustrates how you can create a simple band layout.

You can click band headers to access band settings. For instance, use this approach to change band captions.

Expanded Customizing the Band Layout at Runtime

The example below demonstrates how to create the following layout of bands and columns.

As described in the Bands Overview topic, bands residing at the top hierarchy level are exposed via a View's BandedGridView.Bands collection. Thus, you need to add GridBand objects to this collection in order to create top level bands. Each band, in turn, can contain its own collection of child bands, exposed via its GridBand.Children property. Thus, you should add band objects to such collections to create bands at lower hierarchy levels.

To assign a column to a band, initialize a column's BandedGridColumn.OwnerBand property. After columns have been assigned to bands, you can access a band's column collection via its GridBand.Columns property. Use the collection's GridBandColumnCollection.MoveTo method to reorder columns within their owner band.

The code below shows how to create a band and column layout that matches the design time example above.

Expanded See Also

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