InvalidInputEventArgs クラス

InvalidInput イベント発生の情報を提供します。

構文

Visual Basic (宣言)
C#

Public Class InvalidInputEventArgs 
   Inherits System.EventArgs

public class InvalidInputEventArgs : System.EventArgs

解説

詳細なエラー情報を取得するためには、InvalidInput イベントの EventArgs パラメータを InvalidInputEventArgs にキャストします。InvalidInputEventArgs クラスでは、下記のプロパティからエラーかどうかを判断することができます。

プロパティ	説明
InvalidInputEventArgs.BelowMinValue	入力された値が設定された最小値よりも小さい場合は true 。
InvalidInputEventArgs.ExceedMaxValue	入力された値が設定された最大値よりも大きい場合はtrue。
InvalidInputEventArgs.HasInvalidChar	入力された値が設定された書式に対して無効である場合はtrue。
InvalidInputEventArgs.MeetsLengthLimit	入力された値が設定された最大文字数を超えて無効である場合はtrue。
InvalidInputEventArgs.ValueOutOfRange	入力された値が設定された範囲を超えて無効である場合はtrue。

使用例

次のコードは GcNumber コントロールで InvalidInput イベントを使用し、 InvalidInputEventArgs から詳細なエラー情報を取得する方法を示します。

C#
Visual Basic

//  Please use the following namespace
//  using System.Windows.Forms;
//  using GrapeCity.Win.Editors;

private ErrorProvider errorProvider1 = new ErrorProvider();

public void WireInvalidInputEvent()
{
    GcNumber gcNumber1 = new GcNumber();
    gcNumber1.InvalidInput += new EventHandler(OnGcNumberInvalidInput);
}

private void OnGcNumberInvalidInput(object sender, EventArgs e)
{
    GcNumber gcNumber1 = (sender as GcNumber);

    // EventArgsパラメータをInvalidInputEventArgsにキャストします。
    InvalidInputEventArgs invalidInputEventArgs = e as InvalidInputEventArgs;
    if (invalidInputEventArgs == null)
    {
        return;
    }

    StringBuilder errorInfo = new StringBuilder();

    // 入力された値が設定された書式に対して無効かどうか
    if (invalidInputEventArgs.HasInvalidChar)
    {
        errorInfo.AppendLine("入力された値は設定された書式に対して無効です。");
    }

    // 入力された値が設定された最大文字数を超えているかどうか
    if (invalidInputEventArgs.MeetsLengthLimit)
    {
        errorInfo.AppendLine("入力された値は設定された最大文字数を超えています。");
    }

    // 入力された値が設定された範囲を超えているかどうか
    if (invalidInputEventArgs.ValueOutOfRange)
    {
        errorInfo.AppendLine("入力された値は設定された範囲の範囲外です。");
    }

    // 範囲は、下記のように最大値・最小値で別々に無効かどうかを取得できます。
    // 入力された値が設定された最大値よりも大きいかどうか
    if (invalidInputEventArgs.ExceedMaxValue)
    {
        errorInfo.AppendLine("入力された値は設定された最大値よりも大きい値です。");
    }

    // 入力された値が設定された最小値よりも小さいかどうか
    if (invalidInputEventArgs.BelowMinValue)
    {
        errorInfo.AppendLine("入力された値は設定された最小値よりも小さい値です。");
    }

    if (errorInfo.Length > 0)
    {
        errorProvider1.SetError(gcNumber1, errorInfo.ToString());
    }
    else
    {
        errorProvider1.SetError(gcNumber1, string.Empty);
    }
}

Private errorProvider1 As New ErrorProvider()

Public Sub WireInvalidInputEvent()
    ' Create an instance of a GcNumber control.
    Dim gcNumber1 As New GcNumber()
    ' Wire the InvalidInput event.
    AddHandler gcNumber1.InvalidInput, AddressOf OnGcNumberInvalidInput
End Sub

Private Sub OnGcNumberInvalidInput(ByVal sender As Object, ByVal e As EventArgs)
    Dim gcNumber1 As GcNumber = TryCast(sender, GcNumber)

    ' EventArgsパラメータをInvalidInputEventArgsにキャストします。
    Dim invalidInputEventArgs As InvalidInputEventArgs = TryCast(e, InvalidInputEventArgs)
    If invalidInputEventArgs Is Nothing Then
        Return
    End If

    Dim errorInfo As New StringBuilder()

    ' 入力された値が設定された書式に対して無効かどうか
    If invalidInputEventArgs.HasInvalidChar Then
        errorInfo.AppendLine("入力された値は設定された書式に対して無効です。")
    End If

    ' 入力された値が設定された最大文字数を超えているかどうか
    If invalidInputEventArgs.MeetsLengthLimit Then
        errorInfo.AppendLine("入力された値は設定された最大文字数を超えています。")
    End If

    ' 入力された値が設定された範囲を超えているかどうか
    If invalidInputEventArgs.ValueOutOfRange Then
        errorInfo.AppendLine("入力された値は設定された範囲の範囲外です。")
    End If

    ' 範囲は、下記のように最大値・最小値で別々に無効かどうかを取得できます。
    ' 入力された値が設定された最大値よりも大きいかどうか
    If invalidInputEventArgs.ExceedMaxValue Then
        errorInfo.AppendLine("入力された値は設定された最大値よりも大きい値です。")
    End If

    ' 入力された値が設定された最小値よりも小さいかどうか
    If invalidInputEventArgs.BelowMinValue Then
        errorInfo.AppendLine("入力された値は設定された最小値よりも小さい値です。")
    End If
    
    If errorInfo.Length > 0 Then
        errorProvider1.SetError(gcNumber1, errorInfo.ToString())
    Else
        errorProvider1.SetError(gcNumber1, String.Empty)
    End If
End Sub

継承階層

System.Object
System.EventArgs
GrapeCity.Win.Editors.InvalidInputEventArgs

参照

InvalidInputEventArgs メンバ
 GrapeCity.Win.Editors 名前空間