Skip to main content

CardViewSettings.CellEditorInitialize Property

Enables initializing the cell editors displayed within the CardView edit cells.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v24.2.dll

NuGet Package: DevExpress.Web.Mvc5

#Declaration

public ASPxCardViewEditorEventHandler CellEditorInitialize { get; set; }

#Property Value

Type Description
ASPxCardViewEditorEventHandler

An ASPxCardViewEditorEventHandler delegate method allowing you to implement custom processing.

#Remarks

The CellEditorInitialize event is raised when the CardView is switched to edit mode and enables you to initialize cell editors.

Note

  • Since the CellEditorInitialize event works correctly only when a request is sent to the server to initialize an editor, this event will not be raised after you start editing a new row in Batch edit mode because in this mode, requests are not sent to the server when an editor is activated.
  • The CellEditorInitialize event affects only the edit mode settings (when editors are visible).
  • The CellEditorInitialize event isn’t raised for edit cells that contain custom editors defined using templates.
  • The CellEditorInitialize event fires only for built-in column editors.

#Examples

  • The following example illustrates how to use the CellEditorInitialize event to automatically focus the required column’s editor using the editor’s ASPxWebControl.Focus method (the e.Editor event argument).

    settings.CellEditorInitialize = (s, e) => {
        if (e.Column.FieldName == "TimeFrom")
        {
            e.Editor.Focus();
        }
    };
    
  • This example demonstrates how to prevent an end-user from changing the unit price. To do this, the CellEditorInitialize event is handled. If the processed edit cell corresponds to a column bound to the ‘UnitPrice’ data field, its editor’s ReadOnly property is set to true.

    settings.CellEditorInitialize = (s, e) => {
        MVCxCardView cardViewControl = (MVCxCardView)sender;
        if (cardViewControl.IsNewCardEditing) return;
        if (e.Column.FieldName == "UnitPrice")
            e.Editor.ReadOnly = true;
    }
    
See Also