This documentation is archived and is not being maintained.

TreeView.BeforeLabelEdit Event

Occurs before the tree node label text is edited.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public event NodeLabelEditEventHandler BeforeLabelEdit

For more information about handling events, see Consuming Events.

The following code example demonstrates how to use the BeforeLabelEdit AfterSelect and TopNode members. To run this example, paste the following code in a form containing a TreeView control called TreeView1. Call the InitializeTreeView method in the form's constructor or Load method.

	private void InitializeTreeView()

		// Construct the TreeView object.
		this.TreeView1 = new System.Windows.Forms.TreeView();

		// Set dock, location, size name, and tab order
		// values for the TreeView object.
		TreeView1.Dock = System.Windows.Forms.DockStyle.Left;
		TreeView1.Location = new System.Drawing.Point(0, 0);
		TreeView1.Name = "TreeView1";
		TreeView1.Size = new System.Drawing.Size(152, 266);
		TreeView1.TabIndex = 1;
		// Associate the event-handling methods with the
		// BeforeLabeEdit and the AfterSelect events.
		TreeView1.BeforeLabelEdit += 
			new NodeLabelEditEventHandler(TreeView1_BeforeLabelEdit);
		TreeView1.AfterSelect += 
			new TreeViewEventHandler(TreeView1_AfterSelect);

		// Set the LabelEdit property to true to allow the 
		// user to edit the TreeNode text.
		this.TreeView1.LabelEdit = true;

		// Declare and create objects needed to populate 
		// the TreeView.
		string[] files = new string[]{"bigPresentation.ppt", 
			"myFinances.xls", "myResume.doc"};; 
		string filePath = "c:\\myFiles";
		System.Collections.ArrayList nodes = 
			new System.Collections.ArrayList();

		// Create a node for each file, setting the Text property to the 
		// file's name and the Tag property to file's fully-qualified name.
		foreach ( string file in files )
			TreeNode node = new TreeNode(file);
			node.Tag = filePath+"\\"+file;

		TreeNode[] treeNodes = new TreeNode[nodes.Count];

		// Create a new node named topNode and add the ArrayList of 
		// nodes to topNode.
		TreeNode topNode = new TreeNode("myFiles",  treeNodes);
		topNode.Tag = filePath;

		// Add topNode to the TreeView.

		// Add the TreeView to the form.

	private void TreeView1_BeforeLabelEdit(object sender, 
		NodeLabelEditEventArgs e)

		// Determine whether the user has selected the top node. If so,
		// change the CancelEdit property to true to cancel the edit.  
		if (e.Node == TreeView1.TopNode)

			e.CancelEdit = true;
			MessageBox.Show("You are not allowed to edit the top node");


	// Handle the After_Select event.
	private void TreeView1_AfterSelect(System.Object sender, 
		System.Windows.Forms.TreeViewEventArgs e)

		// Vary the response depending on which TreeViewAction
		// triggered the event. 
			case TreeViewAction.ByKeyboard:
				MessageBox.Show("You like the keyboard!");
			case TreeViewAction.ByMouse:
				MessageBox.Show("You like the mouse!");
		The following method shows the use of the LabelEdit property.
		Add this method to a form containing a ListBox control named ListBox1.

		Call the method in the constructor or Load method of the form.


		The following class inherits from the Button class and overrides
		the OnMouseHover and OnMouseMove methods to give the button
		some special behavior. To use this example create a new form and copy paste this class in the same file, after the form class.  Add a button of
		type FunButton, defined in the code example, to the form. 

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0