バージョン

LimitToList プロパティ

入力値がコントロールのValueListに含まれていない場合、検証時にコントロールにフォーカスを保持するかどうかを示す値を取得または設定します。
シンタックス
'宣言
 
Public Property LimitToList As Boolean
public bool LimitToList {get; set;}
解説

コントロールのエディター部分に入力されたテキスト値がコントロールの値リストに含まれない場合は、Validating イベントの前に ItemNotInList イベントが発生します。LimitToList プロパティが True の場合は Validating イベントがキャンセルされ、値リストに含まれる値を入力しない限りフォーカスが保持されます。

使用例
' LimitToList property
Private Sub Form1_Load(sender As Object, e As System.EventArgs)
 
' The LimitToList property specifies whether the UltraComboEditor will retain focus upon
' validation whenever the entered value is not a value in the control's ValueList.
Me.ultraComboEditor1.LimitToList = True

End Sub 'Form1_Load


' ItemNotInList event
Private Sub ultraComboEditor1_ItemNotInList(sender As Object, e As Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs)

' The ItemNotInList event is fired before the Validating event of the UltraComboEditor whenever
' the text value entered into the editor portion of the control is not a value in the control’s
' ValueList.  The event passes a ValidationErrorEventArgs object that contains InvalidText
' and LastValidValue properties as well as properties for specifying that the UltraComboEditor
' should retain focus or beep to provide an auditory cue.

' Specifies whether the control will retain focus. Overrides the UltraComboEditor's LimitToList
' property if RetainFocus is set to false.
e.RetainFocus = True
   
' Provide an auditory cue that the enetered text is invalid.  If a message box is used this will be
' unnecesary since the message box will provide a beep.
e.Beep = True
   
' Display a message box indicating that the entered text is invalid.
MessageBox.Show(e.InvalidText + " is not a valid value.", "Invalid Entry")
   
' Restore a previously valid value if one was entered, otherwise set a valid default value.
If Not (e.LastValidValue Is Nothing) Then
    Me.ultraComboEditor1.Value = e.LastValidValue
Else
    Me.ultraComboEditor1.SelectedItem = Me.ultraComboEditor1.Items(0)
End If

End Sub 'ultraComboEditor1_ItemNotInList


' IsItemInList overloaded methods
Private Sub button1_Click(sender As Object, e As System.EventArgs)

' The IsItemInList overloaded methods return a boolean indicating whether the value of the
' UltraComboEditor's Text property, or a specified string, is a value in the control's ValueList.
' This provides a convenient way to perform validation in code.

' If the current value of the UltraComboEditor's Text property is not a value in the control's
' ValueList assign a valid text value.
Dim currentTextIsValid As Boolean = Me.ultraComboEditor1.IsItemInList()
If Not currentTextIsValid Then
    Me.ultraComboEditor1.Text = "Some valid text value"
End If 

' If the specified string is not a value in the UltraComboEditor's ValueList assign a valid text value.
Dim someText As String = "Some Text"
Dim itemIsInList As Boolean = Me.ultraComboEditor1.IsItemInList(someText)
   
If itemIsInList Then
    Me.ultraComboEditor1.Text = someText
Else
    System.Diagnostics.Debug.WriteLine((someText + " is not in the list"))
End If

End Sub 'button1_Click
// LimitToList property
     private void Form1_Load(object sender, System.EventArgs e)
     {
         this.ultraComboEditor1.Items.Add( "One" );
         this.ultraComboEditor1.Items.Add( "Two" );
         this.ultraComboEditor1.Items.Add( "Three" );
         this.ultraComboEditor1.Items.Add( "Four" );

         // The LimitToList property specifies whether the UltraComboEditor will retain focus upon
         // validation whenever the entered value is not a value in the control's ValueList.
         this.ultraComboEditor1.LimitToList = true;
     }

// ItemNotInList event
     private void ultraComboEditor1_ItemNotInList(object sender, Infragistics.Win.UltraWinEditors.ValidationErrorEventArgs e)
     {
         // The ItemNotInList event is fired before the Validating event of the UltraComboEditor whenever
         // the text value entered into the editor portion of the control is not a value in the control’s
         // ValueList.  The event passes a ValidationErrorEventArgs object that contains InvalidText
         // and LastValidValue properties as well as properties for specifying that the UltraComboEditor
         // should retain focus or beep to provide an auditory cue.

         // Specifies whether the control will retain focus. Overrides the UltraComboEditor's LimitToList
         // property if RetainFocus is set to false.
         e.RetainFocus = true;

         // Provide an auditory cue that the enetered text is invalid.  If a message box is used this will be
         // unnecesary since the message box will provide a beep.
         e.Beep = true;

         // Display a message box indicating that the entered text is invalid.
         MessageBox.Show( e.InvalidText + " is not a valid value.", "Invalid Entry" );

         // Restore a previously valid value if one was entered, otherwise set a valid default value.
         if ( e.LastValidValue != null )
             this.ultraComboEditor1.Value = e.LastValidValue;
         else
             this.ultraComboEditor1.SelectedItem = this.ultraComboEditor1.Items[0];

     }    

// IsItemInList overloaded methods
     private void button1_Click(object sender, System.EventArgs e)
     {
         // The IsItemInList overloaded methods return a boolean indicating whether the value of the
         // UltraComboEditor's Text property, or a specified string, is a value in the control's ValueList.
         // This provides a convenient way to perform validation in code.

         // If the current value of the UltraComboEditor's Text property is not a value in the control's
         // ValueList assign a valid text value.
         bool currentTextIsValid = this.ultraComboEditor1.IsItemInList();
         if ( !currentTextIsValid )
             this.ultraComboEditor1.Text = "Some valid text value";

         // If the specified string is not a value in the UltraComboEditor's ValueList assign a valid text value.
         string someText = "Some Text";
         bool itemIsInList = this.ultraComboEditor1.IsItemInList( someText );

         if( itemIsInList )
             this.ultraComboEditor1.Text = someText;
         else
             System.Diagnostics.Debug.WriteLine( someText + " is not in the list" );
     }
参照