Version

UIElement Property

Read-only property that returns the main UIElement of the UltraTabControl.
Syntax
'Declaration
 
Public ReadOnly Property UIElement As UltraTabControlUIElement
public UltraTabControlUIElement UIElement {get;}
Example
The following sample code illustrates how UIElements can be used. It finds out what element the user clicked on and outputs some context information about the element.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTabs
Imports Infragistics.Win.UltraWinTabControl

Private Sub ultraTabControl1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles ultraTabControl1.Click

    Dim mainElement As UIElement
    Dim element As UIElement
    Dim screenPoint As Point
    Dim clientPoint As Point
    Dim tabClickedOn As UltraTab

    ' Get the control's main element
    mainElement = Me.ultraTabControl1.UIElement

    ' Convert the current mouse position to a point
    ' in client coordinates of the control.
    screenPoint = Control.MousePosition
    clientPoint = Me.ultraTabControl1.PointToClient(screenPoint)

    ' Get the element at that point
    element = mainElement.ElementFromPoint(clientPoint)

    If element Is Nothing Then Return

    Debug.WriteLine("Clicked on an " + element.GetType().ToString())
    Debug.Indent()

    ' Get the row that contains this element.
    tabClickedOn = element.GetContext(GetType(UltraTab))

    If Not tabClickedOn Is Nothing Then

        Debug.WriteLine("in tab: " + tabClickedOn.Text)

    End If

    ' Walk up the parent element chain and write out a line 
    ' for each parent element.
    While Not element.Parent Is Nothing

        element = element.Parent
        Debug.WriteLine("is a child of an " + element.GetType().ToString())
        Debug.Indent()

    End While

    ' reset the indent level
    Debug.IndentLevel = 0

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

private void ultraTabControl1_Click(object sender, System.EventArgs e)
{

	UIElement mainElement;
	UIElement element;
	Point screenPoint;
	Point clientPoint;
	UltraTab tabClickedOn;

	// Get the control's main element
	mainElement = this.ultraTabControl1.UIElement;
 
	// Convert the current mouse position to a point
	// in client coordinates of the control.
	screenPoint = Control.MousePosition;
	clientPoint = this.ultraTabControl1.PointToClient( screenPoint );

	// Get the element at that point
	element = mainElement.ElementFromPoint( clientPoint );

	if ( element == null )
		return;

	Debug.WriteLine( "Clicked on an " + element.GetType().ToString() );
	Debug.Indent();

	// Get the row that contains this element.
	tabClickedOn = element.GetContext( typeof( UltraTab ) )
					as UltraTab;
	
	if ( tabClickedOn != null )
	{
		Debug.WriteLine( "in tab: " + tabClickedOn.Text );
	}

	// Walk up the parent element chain and write out a line 
	// for each parent element.
	while (element.Parent != null )
	{
		element = element.Parent;
		Debug.WriteLine("is a child of an " + element.GetType().ToString());
		Debug.Indent();
	}

	// reset the indent level
	Debug.IndentLevel = 0;
		
}
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

See Also