Version

UltraExplorerBarStates Enumeration

Bit flags that describe the state of the control.
Syntax
'Declaration
 
Public Enum UltraExplorerBarStates 
   Inherits System.Enum
public enum UltraExplorerBarStates : System.Enum
Members
MemberDescription
ActivateableGroupOrItemExistsAn activateable group or item exists
ActiveGroupExistsActive Group exists
ActiveGroupExpandedActive Group expanded
ActiveGroupInOverflowAreaThe ActiveGroup is in the NavigationOverflowButtonArea.
ActiveGroupIsFirstActivateableOverflowGroupThe Active Group is the first ActivateableGroup in the NavigationOverflowButtonArea.
ActiveGroupIsFirstGroupActive Group is first Group
ActiveGroupIsLastActivateableGroupThe ActiveGroup is the last ActivateableGroup.
ActiveGroupIsLastGroupActive Group is last Group
ActiveGroupIsSelectedActive Group is Selected
ActiveGroupOrItemExistsActive Group or Item exists
ActiveGroupOrItemIsEditableActive Group or Item can be edited via the user interface.
ActiveGroupOrItemIsFirstActive Group or Item is first
ActiveGroupOrItemIsFirstCurrentlyVisibleGroupOrItemActive Group or Item is the first currently visible Group or Item
ActiveGroupOrItemIsLastActive Group or Item is last
ActiveGroupOrItemIsLastCurrentlyVisibleGroupOrItemActive Group or Item is the last currently visible Group or Item
ActiveItemExistsActive Item exists
ActiveItemIsFirstCurrentlyVisibleItemInGroupActive Item is first currently visible Item in Group
ActiveItemIsFirstItemInGroupActive Item is first Item in Group
ActiveItemIsInFirstGroupActive Item is in the First Group
ActiveItemIsInLastGroupActive Item is in the last Group
ActiveItemIsLastCurrentlyVisibleItemInGroupActive Item is last currently visible Item in Group
ActiveItemIsLastItemInGroupActive Item is last Item in Group
ActiveItemIsStateButtonThe style of the current ActiveItem resolves to 'StateButton'
CanTabNextFromActiveGroupOrItemCan perform tab next from the active group or item
CanTabPreviousFromActiveGroupOrItemCan perform tab previous from the active group or item
ExplorerBarModeExplorerBar mode
GroupFollowingActiveGroupExpandedGroup following the Active Group is expanded
GroupFollowingActiveItemGroupExpandedGroup following the Active Item's Group is expanded
GroupPreceedingActiveGroupExpandedGroup preceeding the Active Group is expanded
GroupPreceedingActiveGroupSelectedGroup preceeding the Active Group is selected
GroupPreceedingActiveItemGroupExpandedGroup preceeding the Active Item's Group is expanded
InEditModeIn edit mode
IsMultiColumnLast Group is selected
LastGroupIsSelectedLast Group is selected
ListbarModeListbar mode
NavigationPaneFlyoutVisibleThe navigation pane flyout is currently open.
OutlookNavigationPaneModeOutlookNavigationPane mode
QuickCustomizeButtonActiveThe QuickCustomizeButton in the NavigationOverflowButtonArea is active
VisibleGroupExistsVisible Group exists
VisualStudio2005ToolboxModeVisualStudio2005ToolboxMode
Example
The following code demonstrates how to create a KeyActionMapping and add it to the control's KeyActionMappings collection.

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


	Private Sub Button10_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button10.Click

		' Add a key action mapping that will activate the first group in the control when the
		' F3 key is pressed, but only when the control style is ExplorerBar and the control is
		' not currently editing a Group or Item name.
		Dim myKeyActionMapping As UltraExplorerBarKeyActionMapping = _
			New UltraExplorerBarKeyActionMapping(Keys.F3, _
					  UltraExplorerBarAction.ActivateFirstGroup, _
					  UltraExplorerBarStates.ActiveGroupIsFirstGroup Or UltraExplorerBarStates.InEditMode, _
					  UltraExplorerBarStates.ExplorerBarMode, _
					  0, _
					  0)

		Me.ultraExplorerBar1.KeyActionMappings.Add(myKeyActionMapping)


		' Find the any keyaction mappings that invoke the ActivateLastGroup action and add disallowed
		' and required states.
		Dim keyActionMapping As UltraExplorerBarKeyActionMapping

		For Each keyActionMapping In Me.ultraExplorerBar1.KeyActionMappings
			If (keyActionMapping.ActionCode = UltraExplorerBarAction.ActivateLastGroup) Then
				keyActionMapping.StateDisallowed = keyActionMapping.StateDisallowed Or UltraExplorerBarStates.ListbarMode
				keyActionMapping.StateRequired = keyActionMapping.StateRequired Or UltraExplorerBarStates.ActiveItemIsFirstItemInGroup
			End If
		Next

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


		private void button10_Click(object sender, System.EventArgs e)
		{
			// Add a key action mapping that will activate the first group in the control when the
			// F3 key is pressed, but only when the control style is ExplorerBar and the control is
			// not currently editing a Group or Item name.
			UltraExplorerBarKeyActionMapping myKeyActionMapping = 
						new UltraExplorerBarKeyActionMapping(Keys.F3,
															 UltraExplorerBarAction.ActivateFirstGroup,
															 UltraExplorerBarStates.ActiveGroupIsFirstGroup | UltraExplorerBarStates.InEditMode,
															 UltraExplorerBarStates.ExplorerBarMode,
															 0,
															 0);
															 
			this.ultraExplorerBar1.KeyActionMappings.Add(myKeyActionMapping);


			// Find the any keyaction mappings that invoke the ActivateLastGroup action and add disallowed
			// and required states.
			foreach(UltraExplorerBarKeyActionMapping keyActionMapping in this.ultraExplorerBar1.KeyActionMappings)
			{
				if (keyActionMapping.ActionCode == UltraExplorerBarAction.ActivateLastGroup)
				{
					keyActionMapping.StateDisallowed	|= UltraExplorerBarStates.ListbarMode;
					keyActionMapping.StateRequired	|= UltraExplorerBarStates.ActiveItemIsFirstItemInGroup;
				}
			}
		}
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