RelativeTab Property (TabMovingEventArgs)

The tab that the tab being moved will be adjacent to.

Syntax

Visual Basic

'Declaration
 
Public ReadOnly Property RelativeTab As UltraTab

C#

public UltraTab RelativeTab {get;}

Example

The following code demonstrates how to access some of the information passed in the event arguments of the TabMoving 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 Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabControl

Private Sub ultraTabControl1_TabMoving(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTabControl.TabMovingEventArgs) Handles ultraTabControl1.TabMoving

    ' The following code prevents any tab from being moved
    ' before the first tab.
    If e.RelativeTab.VisibleIndex = 0 And e.RelativePosition = RelativePosition.Before Then
        e.Cancel = True
        Debug.WriteLine("Can't move tab '" + e.Tab.Text + "' before 1st tab.")
    End If

End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinTabs;
using Infragistics.Win.UltraWinTabControl;


private void ultraTabControl1_TabMoving(object sender, Infragistics.Win.UltraWinTabControl.TabMovingEventArgs e)
{
	// The following code prevents any tab from being moved
	// before the first tab.
	if ( e.RelativeTab.VisibleIndex == 0 &&
		 e.RelativePosition == RelativePosition.Before )
	{
		e.Cancel = true;
		Debug.WriteLine("Can't move tab '" + e.Tab.Text + "' before 1st tab.");
	}
}

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