Back to Devexpress

TreeListView.CellValueChanged Event

wpf-devexpress-dot-xpf-dot-grid-dot-treelistview-e1ca81b7.md

latest6.5 KB
Original Source

TreeListView.CellValueChanged Event

Occurs when a cell value is changed.

Namespace : DevExpress.Xpf.Grid

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

NuGet Package : DevExpress.Wpf.Grid.Core

Declaration

csharp
public event TreeListCellValueChangedEventHandler CellValueChanged
vb
Public Event CellValueChanged As TreeListCellValueChangedEventHandler

Event Data

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

PropertyDescription
CellGets a processed cell. Inherited from TreeListCellValueEventArgs.
ColumnGets a column that contains the edited cell. Inherited from TreeListCellValueEventArgs.
HandledGets 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.
NodeGets the processed node. Inherited from TreeListNodeEventArgs.
OldValueGets the cell’s previous value.
OriginalSourceGets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs.
RoutedEventGets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs.
RowGets the processed row. Inherited from TreeListNodeEventArgs.
SourceGets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.
ValueGets or sets the processed cell’s value. Inherited from TreeListCellValueEventArgs.

The event data class exposes the following methods:

MethodDescription
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

CellValueChanging

Immediate Posting

TreeListView Class

TreeListView Members

DevExpress.Xpf.Grid Namespace