[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [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
   [Expand]Binding to Data
   [Expand]Data Layout: Records, Rows and Cells
     Bands View Layout
     Single Record View Layout
     Multiple Records View Layout
   [Expand]Data Editing and Validation
    Formatting Values
   [Expand]Drag and Drop
   [Expand]Appearance and Custom Painting
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Hit Information
    Batch Modifications
   [Expand]Member Tables
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [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]Sunburst 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]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


The Vertical Grid Control (VGridControl) allows you to represent unrderlying data using different formats - layouts. Layouts differ in the number of records they display at a time and in the way they are arranged. This topic demonstrates how to change a layout and briefly explains the differences between each layout. Each layout is described in detail in its own separate topic (links are provided).

The PropertyGridControl supports only one layout, which is equivalent to the Single Record View Layout used in the Vertical Grid Control. The Property Grid Control does not support horizontal scrolling.

Expanded How to Change the Layout

The layout currently applied to a VGridControl control is specified by its VGridControl.LayoutStyle property. The image below demonstrates how the layout can be changed at design time.

The same can also be done in code:

As can be seen from the above image there are three different layout styles which can be applied to a vertical grid control. These layout styles are listed below:

  • Bands View Layout

    When this layout is applied to the control, a single record is displayed at a time. If there are too many fields to fit into the control's area then the records are arranged into columns - bands. This layout is likely to be used if you have a large number of fields to display and want them all to be visible within a grid.

  • Single Record View Layout

    This layout also displays a single record at a time. The difference with the Bands View layout is that the record isn't arranged into columns if it exceeds the control's height. Row headers together with record values occupy the entire grid's width. This layout is likely to be useful if you need to display only a small number of fields and you want to disable standard navigation through records (custom navigation can be implemented). For instance, a single record from the data source can be displayed to each user (e.g. the users of your application can see only their details unless they have extended permissions).

  • Multiple Records View Layout

    Apply this layout to the control to display multiple records within a grid. This type of layout is likely to be useful if you need to display only a small number of fields and want to provide easy navigation through the records to your end-users.

Expanded Scrolling through Records in Different Layouts

Basically, there are three ways in which end-users can navigate through records: using the left and right arrow keys, the mouse wheel or the horizontal scrollbar. However, not all of these navigation methods are supported by each type of layout. The list below describes the methods that are available for scrolling through the records in each layout and explains how they can be enabled or disabled, as well as providing information on how each navigation method works with each particular layout style.

  • Moving focus from record to record using the left and right arrow keys. The table below shows how this type of navigation depends upon the layout applied.


Layout Style Description
Bands View Layout Key navigation through the records is disabled. Left and right arrow keys are used to navigate through the bands in this case.
Single Record View Layout Key navigation is enabled only when the horizontal scrollbar is displayed.
Multiple Records View Layout Key navigation through the records is always enabled.

Navigation through the records in Bands View and Single Record View layout is allowed if the horizontal scrollbar is shown. Otherwise, end-users cannot navigate through the records. The horizontal scrollbar's visibility is specified by the VGridControlBase.ScrollVisibility property.

Expanded See Also

Is this topic helpful?​​​​​​​