PowerTools MultiRow for Windows Forms 8.0J
ErrorText プロパティ (Cell)
使用例 

セルに関連付けられたエラー状態を示すテキストを取得または設定します。
構文
Public Property ErrorText As String
public string ErrorText {get; set;}

プロパティ値

セルに関連付けられたエラー状態を示すテキストを表すSystem.String値。既定値はString.Emptyです。
解説
ErrorTextプロパティは通常、GcMultiRowGcMultiRow.CellValidatingイベントを処理するときに使用します。セルの値がいずれかの検証条件を満たさない場合は、ErrorTextプロパティを設定し、CellValidatingEventArgsのCancelプロパティをtrueに設定してコミット操作をキャンセルします。こうすると、指定したテキストがGcMultiRowによって表示され、ユーザーはセルデータのエラーを修正するよう求められます。GcMultiRowGcMultiRow.VirtualModeプロパティがtrueの場合は、GcMultiRow.RowErrorTextNeededイベントとGcMultiRow.CellErrorTextNeededイベントを使用して行およびセルのエラーテキストを提供できます。セルのErrorTextに異なる文字列を割り当てると、GcMultiRowコントロールのGcMultiRow.CellErrorTextChangedイベントが発生します。
使用例
次のサンプルコードは、このプロパティを使用してセル値のエラーをユーザーに通知する方法を示します。このサンプルを実行するには、Windowsフォームを作成し、GcMultiRowコントロールをそのフォームに追加します。次に、"Age"という名前のNumericUpDownCellをMultiRowコントロールのテンプレートに追加します。さらに、このイベントのイベントハンドラを追加して、次のコードをイベントハンドラにコピーします。実際にエラーがどのように通知されるかを確認するには、このサンプルプログラムを実行し、"Age"セルに無効な値を入力してフォーカスを移動してみます。
void gcMultiRow1_CellValidating(object sender, CellValidatingEventArgs e)
{
    if (e.CellName == "Age")
    {
        int age = int.Parse(e.FormattedValue.ToString());
        if (age < 0 || age > 100)
        {
            e.Cancel = true;

            // Set error text to tell user why the cell validating do not pass.
            this.gcMultiRow1[e.RowIndex, e.CellIndex].ErrorText = "The age should greater than 0 and less than 100.";

            this.gcMultiRow1.EndEdit();
        }
        else
        {
            this.gcMultiRow1[e.RowIndex, e.CellIndex].ErrorText = string.Empty;
        }
    }
}
Private Sub gcMultiRow1_CellValidating(ByVal sender As Object, ByVal e As CellValidatingEventArgs) Handles gcMultiRow1.CellValidating
    If e.CellName = "Age" Then
        Dim age As Integer = Integer.Parse(e.FormattedValue.ToString())
        If age < 0 OrElse age > 100 Then
            e.Cancel = True

            ' Set error text to tell user why the cell validating do not pass.
            Me.gcMultiRow1(e.RowIndex, e.CellIndex).ErrorText = "The age should greater than 0 and less than 100."

            Me.gcMultiRow1.EndEdit()
        Else
            Me.gcMultiRow1(e.RowIndex, e.CellIndex).ErrorText = String.Empty
        End If
    End If
End Sub
参照

Cell クラス
Cell メンバ
ErrorIcon プロパティ
ErrorIconAlignment プロパティ

 

 


© 2008-2015 GrapeCity inc. All rights reserved.