Infragistics2.Win.UltraWinTabControl.v8.1
UltraTabControlKeyActionMappingsCollection Class
See Also  Members   Example 
Infragistics.Win.UltraWinTabControl Namespace : UltraTabControlKeyActionMappingsCollection Class

A Collection of KeyActionMappings that determines how the UltraTabControl or UltraTabStripControl responds to keyboard input.

Object Model

Syntax

Visual Basic (Declaration) 
Public Class UltraTabControlKeyActionMappingsCollection 
   Inherits KeyActionMappingsBase
C# 
public class UltraTabControlKeyActionMappingsCollection : 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).

Visual BasicCopy Code
    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

C#Copy Code
       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 ‘’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 ) );

       }

See Also