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
    [Expand]Binding to Data
     [Expand]Row Operations
      Row Class Structure
      Row Properties
      Category Rows
      Editor Rows
      Multi-Editor Rows
      Fixed Rows
    [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

Editor Rows

The vertical grid controls (VGridControl and PropertyGridControl) provide three different types of rows to allow data to be represented in the most appropriate way. These different row types are all covered in brief in the Rows Overview topic. This topic describes the features provided by editor rows.

Expanded Editor Rows

Editor rows are the most used row type. They are capable of displaying header and data cells - a single cell in each record. If in bound mode editor rows display the values of the fields in the underlying dataset. If in Unbound Mode such rows will display the caption and a single data cell. Thus, editor rows are just the same as columns in standard (horizontal) grid controls - the basic building blocks of data representation.

The image below shows the editor rows.

As with rows of other types, editor rows can be the parents or children of other rows thus forming a hierarchical data structure within a vertical grid. Please refer to the Creating a Tree-Like Structure of Rows topic for details.

Expanded Features of Editor Rows

Editor rows have two sets of settings that affect their appearance and functionality. The first set is common to all rows and is represented by properties inherited from the BaseRow class. These properties specify the expanded state, row height, options, appearance of data cells and visibility.

The second set of settings is represented by the row item settings object which is returned by the EditorRow.Properties property. Since editor rows are capable of displaying the values in a single field, these settings enable you to specify the header's appearance, a set of attributes which affect data binding and the manner in which values are displayed and edited. These properties are listed below:


The image below illustrates an editor row's settings.

The BaseRow.Appearance property provides the appearance settings used to paint data cells.

Expanded Customizing Editor Rows at Runtime

The following code customizes the editor used for the Price field, its height, appearance, header image and the formatting applied to cell values.

The image below shows the result.

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