Version

KeyActionMappings Property (UltraTabControlBase)

The mappings collection that relates key strokes with actions.
Syntax
'Declaration
 
Public ReadOnly Property KeyActionMappings As UltraTabControlKeyActionMappingsCollection
public UltraTabControlKeyActionMappingsCollection KeyActionMappings {get;}
Remarks

The following table lists the default key mappings for the UltraTabControlBase controls:

KeyCode ActionCode StateRequired StateDisallowed SpecialKeysRequired SpecialKeysDisallowed
Up NavigateUp TabsDisplayed Alt
Down NavigateDown TabsDisplayed Alt
Left NavigateLeft TabsDisplayed Alt
Right NavigateRight TabsDisplayed Alt
Home NavigateToFirstTab TabsDisplayed Alt
End NavigateToLastTab TabsDisplayed Alt
Prior NavigatePageUp TabsDisplayed Alt
Next NavigatePageDown TabsDisplayed Alt
Space SelectActiveTab TabsDisplayed ActiveTabIsSelected Alt
Enter SelectActiveTab TabsDisplayed ActiveTabIsSelected Alt
Tab NavigateNextTab TabsDisplayed Ctrl AltShift
Tab NavigatePreviousTab TabsDisplayed ShiftCtrl Alt

Example
The following code illustrates how to add a custom key/action mapping to the tab control that will select the first tab when the tab control has focus and the user presses the ‘H’ key (unless the ‘alt’ key is also pressed).

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

Private Sub LoadNewMappings()

    Dim newMapping As UltraTabControlKeyActionMapping

    ' Add a custom key/action mapping to the tab that 
    ' will navigate to the first tab (if that tab
    ' isn't already selected when the tab control 
    ' has focus and the users presses the ‘H’ key 
    ' (unless the 'alt’ key is also pressed). 
    newMapping = New UltraTabControlKeyActionMapping(Keys.H, UltraTabControlAction.SelectFirstTab, UltraTabControlStates.FirstTab, 0, Infragistics.Win.SpecialKeys.Alt, 0)

    Me.ultraTabControl1.KeyActionMappings.Add(newMapping)

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

private void LoadNewMappings()
{
	// Add a custom key/action mapping to the tab that 
	// will navigate to the first tab (if that tab
	// isn't already selected when the tab control 
	// has focus and the users presses the ‘H’ key 
	// (unless the 'alt’ key is also pressed). 
	this.ultraTabControl1.KeyActionMappings.Add( 
		new UltraTabControlKeyActionMapping( 
			// the key code
			Keys.H,
			// the action to take
			UltraTabControlAction.SelectFirstTab,
			// disallowed state
			UltraTabControlStates.FirstTab, 
			// required state (none)
			0, 
			// disallowed special keys
			Infragistics.Win.SpecialKeys.Alt, 
			// required special keys (none)
			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