The MultiEditorRow class represents the multi-editor row in the VGridControlBase descendants. Rows of this type are used to display the values of several data fields, they are capable of displaying a number of cells within each record and thus the same number of corresponding header cells. The data cell values of multi-editor rows can be modified by end-users using the cell's editors or via code.
Since a multi-editor row can display the data from several row items within each record, it will own a collection of row items. This collection can be accessed via the PropertiesCollection property. Each object in this collection represents settings for an individual row item.
Row items in the multi-editor row are divided by separators. The MultiEditorRow class introduces properties that allow you to specify the separator's appearance. These are the SeparatorKind and SeparatorString properties . The first property specifies whether the separator is a vertical line or a string. If the separator is set to be a string, its textual content is specified by the SeparatorString property.

Example
The example below demonstrates how to create a multi-editor row at runtime using the default constructor. The new multi-editor row is intended to represent and edit the values of two data fields (MPG City and MPG Highway) which contain information about the fuel efficiency of cars. For this purpose, two row items are created, adjusted and added to the row's PropertiesCollection. Since both bound fields are of an identical data type, both row items will use the same editor of the SpinEdit type to display and edit their data.
In the end of the example code's execution, the multi-editor row containing two row items is added to the grid's VGridControlBase.Rows collection.
C# |
using DevExpress.XtraVerticalGrid.Rows;
using DevExpress.XtraEditors.Repository;
MultiEditorRow newMultiEditorRow = new MultiEditorRow();
newMultiEditorRow.Name = "multiEditorRow_MPG";
MultiEditorRowProperties rowItem1 = newMultiEditorRow.PropertiesCollection.Add();
rowItem1.Caption = "MPG City";
rowItem1.FieldName = "MPG City";
MultiEditorRowProperties rowItem2 = newMultiEditorRow.PropertiesCollection.Add("MPG Highway");
rowItem2.Caption = "MPG Highway";
RepositoryItemSpinEdit riSpin = vGridControl1.RepositoryItems.Add("SpinEdit") as
RepositoryItemSpinEdit;
rowItem1.RowEdit = riSpin;
rowItem2.RowEdit = riSpin;
vGridControl1.Rows.Add(newMultiEditorRow);
|
VB |
Imports DevExpress.XtraVerticalGrid.Rows
Imports DevExpress.XtraEditors.Repository
Dim NewMultiEditorRow As New MultiEditorRow()
NewMultiEditorRow.Name = "MultiEditorRow_MPG"
Dim RowItem1 As MultiEditorRowProperties = NewMultiEditorRow.PropertiesCollection.Add()
RowItem1.Caption = "MPG City"
RowItem1.FieldName = "MPG City"
Dim RowItem2 As MultiEditorRowProperties = _
NewMultiEditorRow.PropertiesCollection.Add("MPG Highway")
RowItem2.Caption = "MPG Highway"
Dim RISpin As RepositoryItemSpinEdit = VGridControl1.RepositoryItems.Add("SpinEdit")
RowItem1.RowEdit = RISpin
RowItem2.RowEdit = RISpin
VGridControl1.Rows.Add(NewMultiEditorRow)
|
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
BaseRow
EditorRow
MultiEditorRow