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]Binding to Data
   [Expand]Data Layout: Records, Rows and Cells
   [Expand]Layouts
   [Collapse]Data Editing and Validation
     In-place Editors
     Assigning Editors to Editor Rows
     Assigning Editors to Multi-Editor Rows
     Showing and Hiding Editors
     Validation
    Filtering
    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]Examples
  [Expand]Property Grid
  [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]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Assigning Editors to Editor Rows

This topic describes how to bind editors to editor rows. This editor binding approach is frequently used since editor rows represent data fields that typically contain values of the same type - so it is natural to use the same editor for all cells in a row. Multi-editor rows can display data from several bound data fields, so you can bind multiple editors to a multi-editor row. For more information, see the Assigning Editors to Multi-Editor Rows topic. The In-place Editors topic describes the repository mechanism used to implement in-place editing functionality.

Expanded Assign Editors at Design Time

To specify a row’s in-place editor, create a specific repository item and add it to the vertical grid's internal or external repository. Then, assign it to a row via the RowProperties.RowEdit property.

At design time, the RowProperties.RowEdit property provides a dropdown window that lets you specify the repository item that defines the editor's type, and holds its properties and event handlers. You can assign an item stored within a repository or create a new repository item with default settings. If you create a new repository item, it's automatically added to the control's internal repository.

The example below shows how to use a CalcEdit editor for in-place editing within the Price row.

  1. At design time, right-click the vertical grid and choose Run Designer from the context menu to invoke the VerticalGrid Designer.

  2. In the Designer's Rows page, select the rowPrice row. Click the dropdown button for the RowProperties.RowEdit property and select the CalcEdit item.

    This will create a RepositoryItemCalcEdit object, add it to the control's internal repository and assign it to the rowPrice row.

  3. Close the VerticalGrid Designer and run the application. If you click a cell in the Price row, the CalcEdit will be invoked, allowing you to enter a cell value using a dropdown calculator.

Expanded Assign Editors at Runtime

The sample code below performs the same actions as in the design-time example.

Expanded Unique Cell Editors

It is possible to assign unique editors for individual cells by handling the VGridControlBase.CustomRecordCellEdit event. See this event to learn more.

Expanded Replace Default Editors for Editing

By default, an editor assigned to a Vertical Grid cell is used in both display and edit modes. You can assign a different editor for each mode by handling the VGridControlBase.CustomRecordCellEditForEditing event. In this case, a cell shows data via the display mode editor, and invokes the edit mode editor when a user starts modifying a cell.

Refer to the event description for an example.

Expanded See Also

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