Version

UltraTabControlKeyActionMappingsCollection Class

A Collection of KeyActionMappings that determines how the UltraTabControl or UltraTabStripControl responds to keyboard input.
Syntax
'Declaration
 
Public Class UltraTabControlKeyActionMappingsCollection 
   Inherits Infragistics.Win.KeyActionMappingsBase
public class UltraTabControlKeyActionMappingsCollection : Infragistics.Win.KeyActionMappingsBase
Remarks

This collection is automatically populated with a set of default UltraTabControlKeyActionMapping objects which describe standard keyboard behavior for the UltraTabControl.

UltraTabControlKeyActionMapping objects may be added, edited, or removed to change the keyboard behavior of the UltraTabControl.

The UltraTabControl may trigger more than one action for the same keyboard event. The TreeActionMappins are triggered in the order they exist in the collection.

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