BeforeCellActivate Event

Occurs before an UltraTreeNodeCell is activated.

Syntax

Visual Basic

'Declaration
 
Public Event BeforeCellActivate As BeforeCellActivateEventHandler

C#

public event BeforeCellActivateEventHandler BeforeCellActivate

Event Data

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

Property	Description
Cancel (Inherited from System.ComponentModel.CancelEventArgs)
Cell (Inherited from Infragistics.Win.UltraWinTree.CancelableCellEventArgs)	Returns the UltraTreeNodeCell object for which this instance was created.
Column (Inherited from Infragistics.Win.UltraWinTree.CancelableCellEventArgs)	Returns the UltraTreeNodeColumn for which this instance was created.
Node (Inherited from Infragistics.Win.UltraWinTree.CancelableCellEventArgs)	Returns the UltraTreeNode for which this instance was created.

Example

The following code sample demonstrates how to prevent the activation of a cell based on the containing node's level and the key of the associated column:

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.

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTree

    Private Sub UltraTree1_BeforeCellActivate(ByVal sender As Object, ByVal e As BeforeCellActivateEventArgs) Handles ultraTree1.BeforeCellActivate
        If e.Node.Level > 0 AndAlso e.Column.Key = "ID" Then
            e.Cancel = True
        End If
    End Sub

C#

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

		private void ultraTree1_BeforeCellActivate(object sender, Infragistics.Win.UltraWinTree.BeforeCellActivateEventArgs e)
		{
			if ( e.Node.Level > 0 && e.Column.Key == "ID" )
				e.Cancel = true;
		}

Requirements

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