Version

KeyActionMappings Property (UltraCalendarCombo)

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

The following table lists the default key mappings for the UltraCalendarCombo control:

KeyCode ActionCode StateRequired StateDisallowed SpecialKeysRequired SpecialKeysDisallowed
Left PreviousDayKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Left PreviousDay ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Right NextDayKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Right NextDay ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Up SameDayInPreviousWeekKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Up SameDayInPreviousWeek ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Down SameDayInNextWeekKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Down SameDayInNextWeek ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Home FirstVisibleDayOfWeekKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Home FirstVisibleDayOfWeek ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
End LastVisibleDayOfWeekKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
End LastVisibleDayOfWeek ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Home FirstDayOfMonthKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed, ActiveDayIsFirstVisibleDayInMonth Ctrl AltShift
End LastDayOfMonthKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed, ActiveDayIsLastVisibleDayInMonth Ctrl AltShift
Prior SameDayInPreviousMonthKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Prior SameDayInPreviousMonth ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Next SameDayInNextMonthKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed All
Next SameDayInNextMonth ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Shift AltCtrl
Prior FirstVisibleDayKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Alt ShiftCtrl
Prior FirstVisibleDay ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed AltShift Ctrl
Next LastVisibleDayKeepSelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Alt ShiftCtrl
Next LastVisibleDay ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed AltShift Ctrl
Tab CloseUp MonthPopupDisplayed, DroppedDown AltCtrl
Tab PreviousControl MonthPopupDisplayed, DroppedDown Shift AltCtrl
Tab NextControl MonthPopupDisplayed, DroppedDown All
Space ToggleDaySelection ActiveDay, VisibleMonths, DroppedDown MonthPopupDisplayed Ctrl Alt
Escape CloseMonthPopup MonthPopupDisplayed All
Escape CancelCloseUp DroppedDown MonthPopupDisplayed All
Up SpinUp DroppedDown All
Down SpinDown DroppedDown All
Down ToggleDropDown Alt ShiftCtrl
Up ToggleDropDown Alt ShiftCtrl
Enter ToggleDaySelection DroppedDown MonthPopupDisplayed, AutoCloseUp All
Enter ToggleDaySelection DroppedDown, AutoCloseUp MonthPopupDisplayed All
Enter UpdateValue DroppedDown All
F4 ToggleDropDown All

Example
This example adds a custom key action mapping so that the control's dropdown is displayed when the Enter key is pressed.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinSchedule
Imports Infragistics.Win.UltraWinSchedule.CalendarCombo

    Private Sub CustomizeKeyActionMappings()

        '	Create a new KeyActionMapping object, which we will add to
        '	the control's KeyActionMappings collection. The new KeyActionMapping
        '	object will have the following property settings:
        '
        '	KeyCode = Enter
        '	ActionCode = DropDown
        '	StateDisallowed = DroppedDown
        '	StateRequired = None
        '	SpecialKeysDisallowed = All (disallow the action if either Alt, Ctrl, or Shift is pressed)
        '	SpecialKeysRequired = 0 (no special keys required to perform the action)
        '
        Dim dropDownKeyMapping As KeyActionMapping = New KeyActionMapping(Keys.Enter, CalendarComboAction.DropDown, CalendarComboState.DroppedDown, 0, SpecialKeys.All, 0)

        '	Remove all KeyActionMappings whose action is DropDown or ToggleDropDown
        Dim keyMapping As KeyActionMapping
        For Each keyMapping In Me.ultraCalendarCombo1.KeyActionMappings
            If (keyMapping.ActionCode = CalendarComboAction.DropDown Or keyMapping.ActionCode = CalendarComboAction.ToggleDropDown) Then
                Me.ultraCalendarCombo1.KeyActionMappings.Remove(keyMapping)
            End If
        Next

        '	Now we can add the custom mapping
        Me.ultraCalendarCombo1.KeyActionMappings.Add(dropDownKeyMapping)

    End Sub
using Infragistics.Win;
using Infragistics.Win.UltraWinSchedule;
using Infragistics.Win.UltraWinSchedule.CalendarCombo;

		private void CustomizeKeyActionMappings()
		{

			//--------------------------------------------------------------------------------
			//	KeyActionMappings
			//
			//	This example adds a custom key action mapping so that the control's
			//	dropdown is displayed when the Enter key is pressed.
			//--------------------------------------------------------------------------------

			//	Create a new KeyActionMapping object, which we will add to
			//	the control's KeyActionMappings collection. The new KeyActionMapping
			//	object will have the following property settings:
			//
			//	KeyCode = Enter
			//	ActionCode = DropDown
			//	StateDisallowed = DroppedDown
			//	StateRequired = None
			//	SpecialKeysDisallowed = All (disallow the action if either Alt, Ctrl, or Shift is pressed)
			//	SpecialKeysRequired = 0 (no special keys required to perform the action)
			//
			KeyActionMapping dropDownKeyMapping =
				new KeyActionMapping( Keys.Enter,	//	KeyCode
												 CalendarComboAction.DropDown,		//	ActionCode
												 CalendarComboState.DroppedDown,		//	StateDisallowed
												 0,		//	StateRequired
												 SpecialKeys.All,	//	SpecialKeysDisallowed
												 0 		//	SpecialKeysRequired
												);
			
			//	Remove all KeyActionMappings whose action is DropDown or ToggleDropDown
			foreach( KeyActionMapping keyMapping in this.ultraCalendarCombo1.KeyActionMappings )
			{
				if ( keyMapping.ActionCode == CalendarComboAction.DropDown ||
					 keyMapping.ActionCode == CalendarComboAction.ToggleDropDown )
					this.ultraCalendarCombo1.KeyActionMappings.Remove( keyMapping );

			}

			//	Now we can add the custom mapping
			this.ultraCalendarCombo1.KeyActionMappings.Add( dropDownKeyMapping );

		}
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