次のサンプルコードは、このプロパティを使用してセル値のエラーをユーザーに通知する方法を示します。このサンプルを実行するには、Windowsフォームを作成し、GcMultiRowコントロールをそのフォームに追加します。次に、"Age"という名前のNumericUpDownCellをMultiRowコントロールのテンプレートに追加します。さらに、このイベントのイベントハンドラを追加して、次のコードをイベントハンドラにコピーします。実際にエラーがどのように通知されるかを確認するには、このサンプルプログラムを実行し、"Age"セルに無効な値を入力してフォーカスを移動してみます。
void gcMultiRow_CellValidating(object sender, CellValidatingEventArgs e)
{
if (e.CellName == "Age")
{
int age = int.Parse(e.FormattedValue.ToString());
if (age < 0 || age > 100)
{
e.Cancel = true;
// Show a wave line to notify user, there are some errors.
this.gcMultiRow1[e.RowIndex, e.CellIndex].ShowWaveLine = true;
this.gcMultiRow1.EndEdit();
}
else
{
this.gcMultiRow1[e.RowIndex, e.CellIndex].ShowWaveLine = false;
}
}
}
Private Sub gcMultiRow2_CellValidating(ByVal sender As Object, ByVal e As CellValidatingEventArgs)
If e.CellName = "Age" Then
Dim age As Integer = Integer.Parse(e.FormattedValue.ToString())
If age < 0 OrElse age > 100 Then
e.Cancel = True
' Show a wave line to notify user, there are some errors.
Me.gcMultiRow1(e.RowIndex, e.CellIndex).ShowWaveLine = True
Me.gcMultiRow1.EndEdit()
Else
Me.gcMultiRow1(e.RowIndex, e.CellIndex).ShowWaveLine = False
End If
End If
End Sub