[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Implementation Details
   [Expand]Views
   [Expand]Grid View Data Layout
   [Expand]Binding to Data
   [Expand]Master-Detail Data Representation
   [Collapse]Data Editing and Validation
     Edit Form
     New Item Row
    [Expand]Inplace Editors
    [Expand]Editing in Code
    [Expand]Input Validation
    [Expand]Clipboard Management
     Moving Nodes in TreeList
   [Expand]Grouping
   [Expand]Selection
   [Expand]Filtering and Searching
   [Expand]Sorting
   [Expand]Data Summaries
   [Expand]Paging and Scrolling
   [Expand]Focus and Navigation
   [Expand]Conditional Formatting
   [Expand]Drag-and-Drop
   [Expand]Appearance Customization
   [Expand]MVVM Enhancements
   [Expand]Printing and Exporting
   [Expand]End-User Interaction
   [Expand]Miscellaneous
   [Expand]Performance Improvement
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]End-User Capabilities
   [Expand]Examples
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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

Edit Form

Expanded Overview

The edit form is an alternative approach to edit column values within grid cells. It is available in Table View and TreeList View.

Note

The edit form is available in optimized mode only.

If enabled, the edit form appears when a user double-clicks a grid row.

To control the availability and location of the edit form, use the TableView.EditFormShowMode and TreeListView.EditFormShowMode properties.

The following table lists the available options.

EditFormShowMode property value Description
EditFormShowMode.None The edit form is disabled.
EditFormShowMode.Inline The edit form is shown below the row that is being edited.
EditFormShowMode.InlineHideRow The edit form replaces the row that is being edited.
EditFormShowMode.Dialog The edit form is shown as a popup dialog window.

Changes made by an end-user in the edit form can be immediately displayed in the grid cells if TableView.EditFormPostMode/TreeListView.EditFormPostMode is set to EditFormPostMode.Immediate. If this property is set to EditFormPostMode.Cached, the changes are displayed only after they were saved.

To save changes made using the edit form to the grid, the end-user should click the Update button or press the CTRL+ENTER key combination. To discard unsaved changes, the end-user should click the Cancel button or press the ESC key.

If the edit form contains unsaved changes and the focus is moved away from it, you can display an optional confirmation dialog. To configure the confirmation dialog, use the TableView.EditFormPostConfirmation/TreeListView.EditFormPostConfirmation property.

Expanded Edit Form Customization

Editors within the edit form are arranged in rows from left to right. By default, the edit form contains editors for all columns within the View. Each editor displays a caption to the left of the edit field. The caption contains a display name of the associated grid column. The following table describes various edit form customization scenarios.

Scenario Approach
Change the number of editors displayed in the edit form's rows Use the TableView.EditFormColumnCount and TreeListView.EditFormColumnCount properties.
Exclude a specific column's editor from the edit form Set the corresponding column's ColumnBase.EditFormVisible property to false.
Specify a custom editor caption Use the ColumnBase.EditFormCaption property.
Adjust the size of the column's editor within the edit form Use the ColumnBase.EditFormColumnSpan and ColumnBase.EditFormRowSpan properties.
Note

When the edit form is in dialogue mode, you can specify its title using the TableView.EditFormCaptionBinding and TreeListView.EditFormCaptionBinding properties.

The following example demonstrates GridControl that displays a customized edit form.

The following image demonstrates the result.

Expanded Editors Arrangement

By default, the order of editors in the edit form matches the current order of the corresponding grid columns.

The ColumnBase.EditFormVisibleIndex property allows you to customize the order of editors in the edit form.

Note

By default, all grid columns have the ColumnBase.EditFormVisibleIndex property set to 0.

The following table describes how the ColumnBase.EditFormVisibleIndex property affects the order of the editors within the edit form.

ColumnBase.EditFormVisibleIndex
property value
Position of the corresponding editor in the edit form
0 (default) The editor's position in the edit form is determined based on the BaseColumn.VisibleIndex of the corresponding grid column.
Non-default (greater than 0) The editor's position in the edit form is determined by the ColumnBase.EditFormVisibleIndex property value.

To place an editor on a new edit form row, set the corresponding column's ColumnBase.EditFormStartNewRow property to true.

The following example demonstrates the edit form that displays editors in a custom order.

The following image demonstrates the resulting order of the editors. The order of the Name and Birthday editors matches the order of the corresponding grid columns.

Expanded Appearance Customization

You can customize the edit form and editors nested in it. The following table lists template properties that affect the appearance and functionality of the edit form.

Property Description
TableView.EditFormTemplate
TreeListView.EditFormTemplate
Specify the appearance of the edit form.
ColumnBase.EditFormTemplate Specifies the appearance of the column's editor within the edit form.

The following example demonstrates the GridControl that displays a custom inline edit form. The SpinEdit editor is used for the Visits field.

The following image demonstrates the result.

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