Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

StateRequired Property (KeyActionMapping)

State that the control must be in for the action to be allowed.
Syntax
'Declaration
 
Public Shadows Property StateRequired As CalendarComboState
public new CalendarComboState StateRequired {get; set;}
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