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

行レベルのエラーのエラーメッセージテキストを取得または設定します。
構文
Public Property ErrorText As String
public string ErrorText {get; set;}

プロパティ値

エラーメッセージを含むSystem.String。既定値はString.Emptyです。
解説
このプロパティは、行レベルのエラーのエラーメッセージを提供する場合に使用します。ユーザーが行ヘッダセルに表示されたエラーアイコンの上にマウスポインタを移動すると、指定したメッセージがツールチップに表示されます。この行がGcMultiRowコントロールに関連付けられている場合は、このプロパティを設定するとGcMultiRow.RowErrorTextChangedイベントが発生します。
使用例
次のサンプルコードは、このプロパティを使用して行の値のエラーを通知する方法を示します。このサンプルを実行するには、Windowsフォームを作成し、GcMultiRowコントロールをそのフォームに追加します。次に、RowHeaderCellと、"Name"という名前のTextBoxCellをMultiRowコントロールのテンプレートに追加します。さらに、このイベントのイベントハンドラを追加して、次のコードをイベントハンドラにコピーします。実際にエラーがどのように通知されるかを確認するには、このサンプルプログラムを実行し、"Name"セルに無効な値を入力してフォーカスを移動してみます。
void gcMultiRow1_RowValidating(object sender, CellCancelEventArgs e)
{
    if (e.CellName == "Name" && this.gcMultiRow1[e.RowIndex, "Name"].Value == null)
    {
        e.Cancel = true;

        // Set error text to tell user why the cell validating do not pass.
        this.gcMultiRow1.Rows[e.RowIndex].ErrorText = "The student name can't be empty, please input the name.";
    }
    else
    {
        this.gcMultiRow1.Rows[e.RowIndex].ErrorText = string.Empty;
    }
}
Private Sub gcMultiRow1_RowValidating(ByVal sender As Object, ByVal e As CellCancelEventArgs) Handles gcMultiRow1.RowValidating
    If e.CellName = "Name" AndAlso Me.gcMultiRow1(e.RowIndex, "Name").Value = Nothing Then
        e.Cancel = True

        ' Set error text to tell user why the cell validating do not pass.
        Me.gcMultiRow1.Rows(e.RowIndex).ErrorText = "The student name can't be empty, please input the name."
    Else
        Me.gcMultiRow1.Rows(e.RowIndex).ErrorText = String.Empty
    End If
End Sub
参照

Row クラス
Row メンバ
ShowRowErrors プロパティ

 

 


© 2008-2015 GrapeCity inc. All rights reserved.