New to Telerik UI for WinFormsStart a free 30-day trial

Selecting Nodes

Updated over 6 months ago

Selecting a Single Node

To select a node use the Selected property of RadTreeNode. The following example demonstrates how to do it.

C#
radTreeView1.SelectedNode = radTreeView1.Nodes[0];

Selecting Multiple Nodes

To enable the multiple selection the MultiSelect property must be set to true. The default value is false.

SelectionExampleDescription
Single SelectionWinForms RadTreeView Single SelectionThe user can select a single node by clicking the node.
Multiple Selection using the Shift keyWinForms RadTreeView Multiple Selection using the Shift keyTo select a continuous series of multiple nodes at one time hold Shift and click on a node using the mouse. That will select all nodes between the first selected node and the node that was just clicked. The screenshot shows nodes selected between "Deleted Items" and "Large Mail".
Multiple Selection using the Ctrl keyWinForms RadTreeView Multiple Selection using the Ctrl keyTo select multiple nodes in distributed throughout, hold Ctrl and click on each node using the mouse. That will select the clicked node or unselect the previously selected nodes. The screenshot shows the "Deleted Items" and "Send Items" nodes selected.

Selecting Multiple Nodes Programmatically

To select multiple nodes through the API, just set the Selected property of the desired nodes to true. The example below adds four nodes, then selects the last two nodes.

C#
radTreeView1.MultiSelect = true;
RadTreeNode Node1 = new RadTreeNode("Inbox");
RadTreeNode Node2 = new RadTreeNode("Deleted Items");
RadTreeNode Node3 = new RadTreeNode("Outbox");
RadTreeNode Node4 = new RadTreeNode("Sent");
radTreeView1.Nodes.Add(Node1);
radTreeView1.Nodes.Add(Node2);
radTreeView1.Nodes.Add(Node3);
radTreeView1.Nodes.Add(Node4);
Node3.Selected = true;
Node4.Selected = true;

SelectedNodeChanged Event

When multiple selection functionality is turned on, the SelectedNodeChanged event will be called twice: first for the previously selected node first and one more time for the newly selected node. In the RadTreeViewEventArgs you can distinguish the two event firings by the Action property which is set to Unknown when the selection is cleared.

C#
private void radTreeView1_SelectedNodeChanged(object sender, Telerik.WinControls.UI.RadTreeViewEventArgs e)
{
    if (e.Action != Telerik.WinControls.UI.RadTreeViewAction.ByMouse)
    {
        Console.WriteLine(e.Node.Text);
    }
}

Another approach will be to check the Selected property of the node. If it is true, execute your logic.

C#
private void radTreeView2_SelectedNodeChanged(object sender, RadTreeViewEventArgs e)
{
    if (e.Node.Selected == true)
    {
        Console.WriteLine(e.Node.Text);
    }
}

See Also