ActiveItem Property

Return/sets the UltraExplorerBarItem that currently has the focus.

Syntax

Visual Basic

'Declaration
 
Public Property ActiveItem As UltraExplorerBarItem

C#

public UltraExplorerBarItem ActiveItem {get; set;}

Remarks

If the control cannot accept focus because its TabStop property has been set to False, or if no Item currently has the focus, this property returns null.

When this property is set, the Item becomes the active Item and the active focus rect is shown around the item.

Example

The following code shows how to manipuate the ActiveGroup and ActiveItem properties.

Visual Basic

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


	Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button2.Click

		' If there is an ActiveGroup set, set the ActiveItem to the first item within the 
		' ActiveGroup.
		If (Not Me.ultraExplorerBar1.ActiveGroup Is Nothing AndAlso Me.ultraExplorerBar1.ActiveGroup.Items.Count > 0) Then
			Me.ultraExplorerBar1.ActiveItem = Me.ultraExplorerBar1.ActiveGroup.Items(0)

			Return
		End If


		' If there is an ActiveItem set, set the ActiveGroup to the group containing the item.
		If (Not Me.ultraExplorerBar1.ActiveItem Is Nothing) Then
			Me.ultraExplorerBar1.ActiveGroup = Me.ultraExplorerBar1.ActiveItem.Group

			Return
		End If
	End Sub

C#

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


		private void button2_Click(object sender, System.EventArgs e)
		{
			// If there is an ActiveGroup set, set the ActiveItem to the first item within the 
			// ActiveGroup.
			if (this.ultraExplorerBar1.ActiveGroup				!= null  &&
				this.ultraExplorerBar1.ActiveGroup.Items.Count  >  0)
			{
				this.ultraExplorerBar1.ActiveItem = this.ultraExplorerBar1.ActiveGroup.Items[0];

				return;
			}


			// If there is an ActiveItem set, set the ActiveGroup to the group containing the item.
			if (this.ultraExplorerBar1.ActiveItem	!= null)
			{
				this.ultraExplorerBar1.ActiveGroup = this.ultraExplorerBar1.ActiveItem.Group;

				return;
			}
		}

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