Back to Devexpress

CellValueChangedEventHandler Delegate

windowsforms-devexpress-dot-xtragrid-dot-views-dot-base-6f5ee766.md

latest3.6 KB
Original Source

CellValueChangedEventHandler Delegate

Represents a method that will handle the ColumnView.CellValueChanging and ColumnView.CellValueChanged events.

Namespace : DevExpress.XtraGrid.Views.Base

Assembly : DevExpress.XtraGrid.v25.2.dll

NuGet Packages : DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

csharp
public delegate void CellValueChangedEventHandler(
    object sender,
    CellValueChangedEventArgs e
);
vb
Public Delegate Sub CellValueChangedEventHandler(
    sender As Object,
    e As CellValueChangedEventArgs
)

Parameters

NameTypeDescription
senderObject

The event sender (the BaseView descendant representing the View that raised the event).

| | e | CellValueChangedEventArgs |

A CellValueChangedEventArgs object that contains event data.

|

Remarks

When you create a CellValueChangedEventHandler delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about delegates, see Events and Delegates in MSDN.

Example

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

csharp
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
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

See Also

DevExpress.XtraGrid.Views.Base Namespace