TreeView.OnSelectedNodeChanged(EventArgs) Method

Definition

Raises the SelectedNodeChanged event of the TreeView control.

C#
protected virtual void OnSelectedNodeChanged(EventArgs e);

Parameters

e
EventArgs

An EventArgs that contains event data.

Remarks

The SelectedNodeChanged event is raised when a node is selected in the TreeView control. This allows you to provide an event-handling method that performs a custom routine, such as updating the displayed content, whenever this event occurs.

You can optionally set the SelectAction property of a node to specify which event is raised when that node is selected.

Note

The HoverNodeStyle is not rendered for a node with its SelectAction property set to TreeNodeSelectAction.None.

Raising an event invokes the event handler through a delegate. For more information about how to handle events, see Handling and Raising Events.

The OnSelectedNodeChanged method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors

When overriding the OnSelectedNodeChanged(EventArgs) method in a derived class, be sure to call the OnSelectedNodeChanged(EventArgs) method for the base class so that registered delegates receive the event.

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also