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
    [Expand]Layouts
    [Collapse]Binding to Data
      Unbound Mode
      Unbound Rows
    [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]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]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Unbound Mode

This topic describes how to use the Vertical Grid Control (VGridControl) when it isn't bound to any data source (unbound mode). For a list of all the data modes supported by the vertical grid controls, see the Data Modes Overview topic.

 

Expanded Unbound Mode Overview

A vertical grid control functions in Unbound Mode if it isn't bound to any data source, this means that the VGridControl.DataSource property's value is null.

Unbound mode is appropriate for displaying lists of label-value pairs which can be optionally categorized, as in the image below:

For instance, you can use unbound mode if you need to edit a number of option values, which may have different data types. If you need to display and edit properties of a specific object you can also consider using the PropertyGridControl.

Like in bound mode, in unbound mode you can assign editors to cells to provide a handy way to edit cell values. Any editor from the DevExpress Editors Library can be used. In addition you can organize rows into categories and create hierarchy structures.

Generally, implementing unbound mode involves the following steps:

  • create the required rows and arrange them in a specific manner;
  • associate editors with the created rows (row items);
  • use the row's RowProperties.Value property to set initial cell values.

Expanded An Example of Using Unbound Mode

This example will create two editor rows in a VGridControl which are united into a single category. The first row ('Output Path') will use the text editor to edit its value. Another row ('Generate Debugging Information') will use the check box.

Follow the steps below:

  1. Run the control's Designer. To do this, right-click on the control and choose the Run Designer item from its context menu.

  2. Ensure that the Rows Page is open. Use the down arrow button to invoke the dropdown window which lists the row types. Choose the CategoryRow item. This will add a category row to the vertical grid. Add two editor rows in a similar manner. Drag the editor rows to the category row to include them in that category.

  3. Select the category row. Set its RowProperties.Caption property to 'Outputs'. The image below demonstrates how to do this. In the same way specify the 'Output Path' and 'Generate Debugging Information' captions to the editor rows.

  4. Select the 'Generate Debugging Information' row and bind a check box editor to it. The image below demonstrates how to do this.

  5. Specify a value for the 'Generate Debugging Information' row's value. This can be done using the Object Editor dialog which is invoked by clicking on the button which corresponds to the RowProperties.Value property.

  6. Set the 'Output Path' row's RowProperties.Value property to the 'Outputs\Debug' string.

  7. Close the VerticalGrid Designer and run the application. The image below shows the result.

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