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
  [Expand]Data Grid
  [Collapse]Vertical Grid
      Bands View Layout
      Single Record View Layout
      Multiple Records View Layout
    [Expand]Binding to Data
    [Expand]In-place Editors
     Hit Information
    [Expand]Custom Painting
    [Expand]Alpha Blending and Background Images
    [Expand]Customization Form
     Batch Modifications
    [Expand]Drag and Drop
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [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]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Bands View Layout

This topic describes the Bands View layout which is available in the Vertical Grid Control (VGridControl). For an overview of all the layouts that can be applied to the control, see the Layouts Overview topic.

Expanded Main Features of The Bands View Layout

The image below shows a VGridControl control with the Bands view layout applied to it.

The features specific to this layout are listed below:

  • A single record (or part of one) is displayed at a time. End-users can navigate through the records using the horizontal scroll bar. (You can provide your users with a custom method of scrolling through records. See the Scrolling Through Records topic for details.)
  • The control's contents cannot be scrolled vertically. The row header cells and data cells are arranged into a number of columns that won't exceed the grid's height. These columns are bands.
  • Bands can either exceed the control's width (requiring scrolling to view all the bands) or be adjusted to fit the control's width. See SCROLLING BANDS below for more information.
  • end-users can resize bands by dragging the right border of the leftmost visible band.


The following list enumerates properties specific to this layout.

Expanded Scrolling Bands

If the grid's BaseOptionsView.AutoScaleBands property is set to true, bands will be resized (stretched or shrunk as appropriate) to exactly occupy the grid's entire client region. Otherwise, if the total width of the bands exceeds that of the grid's client region and the grid's BaseOptionsView.AutoScaleBands property is set to false some of the bands will be outside the visible area.

If a band is partially visible, end-users can make it completely visible by clicking its data cells or by scrolling through the bands using the mouse wheel if the VGridOptionsBehavior.RecordsMouseWheel property is set to false. This property can be accessed via the grid's VGridControlBase.OptionsBehavior property.

The following sample code demonstrates how to scroll bands via code. The VGridControlBase.LeftVisibleBand property is used for this purpose. It's assumed that there are two buttons in your application: 'btnForward' and 'btnBackward'. These buttons scroll the bands forward and backwards, respectively. When the first or last band is reached the corresponding button is disabled. The handlers for the button clicks are listed below.

Expanded See Also

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