CellValueChangedEventArgs Class

Provides data for the ColumnView.CellValueChanging and ColumnView.CellValueChanged events.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v18.1.dll

Declaration

C#

public class CellValueChangedEventArgs :
    EventArgs

VB.NET

Public Class CellValueChangedEventArgs
    Inherits EventArgs

Related API Members

CellValueChangedEventArgs is the data class for the following events:

• ColumnView.CellValueChanged
• ColumnView.CellValueChanging

Remarks

The ColumnView.CellValueChanging and ColumnView.CellValueChanged events fire in response to cell value modifications. Thus, CellValueChangedEventArgs class members allow you to identify the cell and obtain its current value. The processed cell is identified by the CellValueChangedEventArgs.RowHandle and CellValueChangedEventArgs.Column properties. The CellValueChangedEventArgs.Value property holds the newly assigned value.

CellValueChangedEventArgs objects with proper settings are automatically created and passed to ColumnView.CellValueChanging and ColumnView.CellValueChanged event handlers.

Example

The following sample code handles the ColumnView.CellValueChanged event to update the FullName column value after the FirstName column value has been changed.

C#

using DevExpress.XtraGrid.Views.Base;
using DevExpress.XtraGrid.Views.BandedGrid;

private void bandedGridView1_CellValueChanged(object sender, CellValueChangedEventArgs e) {
    BandedGridView view = sender as BandedGridView;
    if (view == null) return;
    if (e.Column.Caption != "FirstName") return;
    string cellValue = e.Value.ToString() + " " + view.GetRowCellValue(e.RowHandle, view.Columns["LastName"]).ToString();
    view.SetRowCellValue(e.RowHandle, view.Columns["FullName"], cellValue);
}

VB.NET

Imports DevExpress.XtraGrid.Views.Base
Imports DevExpress.XtraGrid.Views.BandedGrid

Private Sub BandedGridView1_CellValueChanged(sender As Object, e As DevExpress.XtraGrid.Views.Base.CellValueChangedEventArgs) Handles BandedGridView1.CellValueChanged
    Dim view As BandedGridView = sender
    If view Is Nothing Then
        Return
    End If
    If e.Column.Caption <> "FirstName" Then
        Return
    End If
    Dim cellValue As String = e.Value.ToString() + " " + view.GetRowCellValue(e.RowHandle, view.Columns("LastName")).ToString()
    view.SetRowCellValue(e.RowHandle, view.Columns("FullName"), cellValue)
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CellValueChangedEventArgs class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-edit-multiple-values-in-gridview-at-the-same-time-e2779/CS/MultiSelectionEditingHelper.cs#L41

void view_CellValueChanged(object sender, CellValueChangedEventArgs e)
{

how-to-highlight-modified-cells-in-grid-t190692/CS/Form1.cs#L25

void gridView1_CellValueChanged(object sender, DevExpress.XtraGrid.Views.Base.CellValueChangedEventArgs e) {
    if (!CellExists(gridView1.GetDataSourceRowIndex(e.RowHandle), e.Column)){

how-to-implement-a-flashing-cell-in-gridview-e2987/CS/Form1.cs#L54

private void gridView1_CellValueChanged(object sender, CellValueChangedEventArgs e)
{

how-to-replace-the-default-filter-popup-with-a-custom-one-e4897/CS/E4669CS/CustomFieldFilterControl.cs#L85

bool internalChange = false;
private void gridView1_CellValueChanged(object sender, DevExpress.XtraGrid.Views.Base.CellValueChangedEventArgs e)
{

how-to-create-a-comboboxedit-control-with-mru-capabilities-e2551/CS/WindowsFormsApplication18/Form1.cs#L26

private void gridView1_CellValueChanged(object sender, CellValueChangedEventArgs e)
{

VB.NET

how-to-edit-multiple-values-in-gridview-at-the-same-time-e2779/VB/MultiSelectionEditingHelper.vb#L35

Private Sub view_CellValueChanged(ByVal sender As Object, ByVal e As CellValueChangedEventArgs)
    OnCellValueChanged(e)

how-to-highlight-modified-cells-in-grid-t190692/VB/Form1.vb#L27

Private Sub gridView1_CellValueChanged(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Base.CellValueChangedEventArgs)
    If (Not CellExists(gridView1.GetDataSourceRowIndex(e.RowHandle), e.Column)) Then

how-to-implement-a-flashing-cell-in-gridview-e2987/VB/Form1.vb#L52

Private Sub gridView1_CellValueChanged(ByVal sender As Object, ByVal e As CellValueChangedEventArgs) Handles gridView1.CellValueChanged
    Dim speed As Integer = CInt(Fix(e.Value))

how-to-replace-the-default-filter-popup-with-a-custom-one-e4897/VB/CustomFieldFilterControl.vb#L83

Private internalChange As Boolean = False
Private Sub gridView1_CellValueChanged(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Base.CellValueChangedEventArgs) Handles gridView1.CellValueChanged
    If internalChange Then

how-to-create-a-comboboxedit-control-with-mru-capabilities-e2551/VB/WindowsFormsApplication18/Form1.vb#L25

Private Sub gridView1_CellValueChanged(ByVal sender As Object, ByVal e As CellValueChangedEventArgs) Handles gridView1.CellValueChanged
    If TypeOf e.Column.ColumnEdit Is RepositoryItemMRUComboBox Then

Inheritance

Object

EventArgs

CellValueChangedEventArgs