BeforeLabelEdit Event

Occurs before an UltraTreeNode goes into label edit mode.
Public Event BeforeLabelEdit As BeforeNodeChangedEventHandler
public event BeforeNodeChangedEventHandler BeforeLabelEdit
Event Data

The event handler receives an argument of type CancelableNodeEventArgs containing data related to this event. The following CancelableNodeEventArgs properties provide information specific to this event.

Cancel (Inherited from System.ComponentModel.CancelEventArgs) 
TreeNode The UltraTreeNode (read-only)

The CancelableNodeEventArgs.TreeNode property of the CancelableNodeEventArgs contains a reference to UltraTreeNode that is about to go into label edit mode.

Setting the System.ComponentModel.CancelEventArgs.Cancel property to true will prevent the UltraTreeNode from going into label edit mode.

The following sample code illustrates some of the information available in the BeforeLabelEdit event.

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

Imports Infragistics.Win.UltraWinTree

Private Sub ultraTree1_BeforeLabelEdit(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTree.CancelableNodeEventArgs) Handles ultraTree1.BeforeLabelEdit

    Dim sb As New System.Text.StringBuilder()

    sb.Append("Node: ")

    sb.Append(" is about to enter edit mode.")

    Dim dr As DialogResult
    dr = MessageBox.Show(Me, _
      sb.ToString(), _
      "Node entering edit mode", _

    If dr = DialogResult.Cancel Then e.Cancel = True

End Sub
using System.Diagnostics;
using Infragistics.Win.UltraWinTree;

private void ultraTree1_BeforeLabelEdit(object sender, Infragistics.Win.UltraWinTree.CancelableNodeEventArgs e)

	System.Text.StringBuilder sb = new System.Text.StringBuilder();

	sb.Append("Node: ");
	sb.Append(" is about to enter edit mode.");
	DialogResult dr = MessageBox.Show( this,
						  "Node entering edit mode",
						  MessageBoxButtons.OKCancel );
	if ( dr == DialogResult.Cancel )
		e.Cancel = true;

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also