Skip to main content

TreeListView.CellValueChanged Event

Occurs when a cell value is changed.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v24.2.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

public event TreeListCellValueChangedEventHandler CellValueChanged

Event Data

The CellValueChanged event's data class is TreeListCellValueChangedEventArgs. The following properties provide information specific to this event:

Property Description
Cell Gets a processed cell. Inherited from TreeListCellValueEventArgs.
Column Gets a column that contains the edited cell. Inherited from TreeListCellValueEventArgs.
Handled Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route. Inherited from RoutedEventArgs.
Node Gets the processed node. Inherited from TreeListNodeEventArgs.
OldValue Gets the cell’s previous value.
OriginalSource Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEvent Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
Row Gets the processed row. Inherited from TreeListNodeEventArgs.
Source Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.
Value Gets or sets the processed cell’s value. Inherited from TreeListCellValueEventArgs.

The event data class exposes the following methods:

Method Description
InvokeEventHandler(Delegate, Object) When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation. Inherited from RoutedEventArgs.
OnSetSource(Object) When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes. Inherited from RoutedEventArgs.

Remarks

The TreeListView raises the CellValueChanged event in the following cases:

  • A user changes a cell value and closes the in-place editor.
  • You use the GridControl.SetCellValue method to change a cell value in code.

The CellValueChanged event does not occur when you change a cell value in a data source.

The TreeListEditorEventArgs.Node and TreeListCellValueEventArgs.Column properties identify a cell whose value is changed. The TreeListCellValueEventArgs.Value property returns a new cell value.

Refer to the following topic for more information: Obtain and Set Cell Values in Code.

If you want to maintain a clean MVVM pattern and process cell value changes in a View Model, create a command and bind it to the CellValueChangedCommand property.

See Also