ActiveItemChanging Event

Occurs before the ActiveItem changes.

Syntax

Visual Basic

'Declaration
 
Public Event ActiveItemChanging As ActiveItemChangingEventHandler

C#

public event ActiveItemChangingEventHandler ActiveItemChanging

Event Data

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

Property	Description
Cancel (Inherited from System.ComponentModel.CancelEventArgs)
Item	Read-only property that returns the UltraExplorerBarItem associated with the CancelableItemEventArgs.

Remarks

This event fires before the process of changing the active item has begun.

Example

The following code shows how to process the ActiveItemChanging 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.

Visual Basic

Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinExplorerBar


	Private Sub ultraExplorerBar1_ActiveItemChanging(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinExplorerBar.CancelableItemEventArgs) Handles ultraExplorerBar1.ActiveItemChanging

		' Don't allow the ActiveItem to change if the current active item has a key of 'Tools'
		If (e.Item.Key = "Tools") Then
			e.Cancel = True
		End If

	End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinExplorerBar;


		private void ultraExplorerBar1_ActiveItemChanging(object sender, Infragistics.Win.UltraWinExplorerBar.CancelableItemEventArgs e)
		{
			// Don't allow the ActiveItem to change if the current active item has a key of 'Tools'
			if (e.Item.Key == "Tools")
				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