All docs
V21.1
21.2 (EAP/Beta)
21.1
20.2
20.1
19.2
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.

TreeListView.NodeCanceled Event

Occurs when the changes made in a node are discarded.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.1.dll

Declaration

public event TreeListNodeEventHandler NodeCanceled

Event Data

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

Property Description
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.
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.
Source Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs.

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

You can discard changes made within a node while the node has focus. The GridControl updates the data source when focus moves to another node.

Press ESC twice to discard changes. Press ESC the first time to close the editor and discard all changes made in the current cell. Then press ESC again to call the IEditableObject.CancelEdit method that discards changes made in other cells of the focused node.

The NodeCanceled event occurs when you press ESC the second time. The Node property returns the processed node.

Note

If a data item class does not implement the IEditableObject interface, you can discard changes only in the focused cell.

If you want to maintain a clean MVVM pattern and process the node edit discard operation in a View Model, create a command and bind it to the NodeCanceledCommand property.

Refer to the following topic if you want to cancel changes made within a row asynchronously: UpdateRowResult.

See Also