StateRequired プロパティ (KeyActionMapping)

アクションを実行するために必須のコントロールの状態

シンタックス

Visual Basic

'宣言
 
Public Shadows Property StateRequired As CalendarComboState

C#

public new CalendarComboState StateRequired {get; set;}

使用例

Visual Basic

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

C#

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 );

		}