ShowWaveLine プロパティ

セルに波線を表示するかどうかを示す値を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property ShowWaveLine As Boolean

public bool ShowWaveLine {get; set;}

プロパティ値

セルに波線を表示する場合はtrue。それ以外の場合はfalse。既定値はfalseです。

解説

このプロパティをtrueに設定すると、セルの下部に下線が1本表示されます。

このプロパティは、ToolTipTextプロパティと組み合わせて使用できます。ユーザーにエラー情報を表示する際、このプロパティをtrueに設定し、ToolTipTextをエラー文字列に設定します。そうすると、セルの下部に下線が1本表示され、セルの上にマウスを置くとToolTipTextが表示されます。また、下線の色はWaveLineColorプロパティを通じて変更できます。下線を編集モードで表示する場合は、GcMultiRowのGcMultiRow.ShowWaveLineInEditingStatusプロパティをtrueに設定します。

使用例

次のサンプルコードは、このプロパティを使用してセル値のエラーをユーザーに通知する方法を示します。このサンプルを実行するには、Windowsフォームを作成し、GcMultiRowコントロールをそのフォームに追加します。次に、"Age"という名前のNumericUpDownCellをMultiRowコントロールのテンプレートに追加します。さらに、このイベントのイベントハンドラを追加して、次のコードをイベントハンドラにコピーします。実際にエラーがどのように通知されるかを確認するには、このサンプルプログラムを実行し、"Age"セルに無効な値を入力してフォーカスを移動してみます。

C#
Visual Basic

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

参照

Cell クラス
 Cell メンバ
 WaveLineColor プロパティ
 ShowWaveLineInEditingStatus プロパティ