Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Overview
   [Expand]Fundamentals
   [Collapse]Concepts
     Filtering
    [Collapse]Layouts
      Bands View Layout
      Single Record View Layout
      Multiple Records View Layout
    [Expand]Binding to Data
    [Expand]Rows
    [Expand]Records
    [Expand]Cells
    [Expand]In-place Editors
     Formatting
    [Expand]Appearances
     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]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [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]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Layouts

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.
Note

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

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