DataGridView.CellValueChanged イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridView.CellValueChanged イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

セルの値が変更された場合に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event CellValueChanged As
 DataGridViewCellEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellEventHandler

AddHandler instance.CellValueChanged, handler

public event DataGridViewCellEventHandler CellValueChanged

C++

public:
event DataGridViewCellEventHandler^ CellValueChanged {
    void add (DataGridViewCellEventHandler^ value);
    void remove (DataGridViewCellEventHandler^ value);
}

/** @event */
public void add_CellValueChanged (DataGridViewCellEventHandler
 value)

/** @event */
public void remove_CellValueChanged (DataGridViewCellEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

DataGridView.CellValueChanged イベントは、ユーザー指定の値がコミットされたとき (通常はフォーカスがセルを離れたとき) に発生します。

ただし、チェックボックスセルの場合、通常は変更をすぐに処理する必要があります。セルがクリックされたときに変更をコミットするには、DataGridView.CurrentCellDirtyStateChanged イベントを処理する必要があります。ハンドラでは、現在のセルがチェックボックスセルの場合、DataGridView.CommitEdit メソッドを呼び出して、Commit 値を渡します。

セルの値を変更しても、コントロールの行は、自動的には並べ替えられません。ユーザーがセルに変更を加えたときにコントロールを並べ替えるには、CellValueChanged イベントハンドラで Sort メソッドを呼び出します。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

CellValueChanged イベントを使用して、DataGridView の残高列の値を更新するコード例を次に示します。

Visual Basic

Private Sub CellValueChanged(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles DataGridView1.CellValueChanged

    ' Update the balance column whenever the values of any cell changes.
    UpdateBalance()
End Sub

Private Sub RowsRemoved(ByVal
 sender As Object, _
    ByVal e As DataGridViewRowsRemovedEventArgs)
 _
    Handles DataGridView1.RowsRemoved

    ' Update the balance column whenever rows are deleted.
    UpdateBalance()
End Sub

Private Sub UpdateBalance()
    Dim counter As Integer
    Dim balance As Integer
    Dim deposit As Integer
    Dim withdrawal As Integer

    ' Iterate through the rows, skipping the Starting Balance Row.
    For counter = 1 To (DataGridView1.Rows.Count
 - 2)
        deposit = 0
        withdrawal = 0
        balance = Integer.Parse(DataGridView1.Rows(counter - 1)
 _
            .Cells("Balance").Value.ToString())

        If Not DataGridView1.Rows(counter)
 _
            .Cells("Deposits").Value Is
 Nothing Then

            ' Verify that the cell value is not an empty string.
            If Not DataGridView1.Rows(counter)
 _
                .Cells("Deposits").Value.ToString().Length
 = 0 Then
                deposit = Integer.Parse(DataGridView1.Rows(counter)
 _
                    .Cells("Deposits").Value.ToString())
            End If
        End If

        If Not DataGridView1.Rows(counter)
 _
            .Cells("Withdrawals").Value Is
 Nothing Then
            If Not DataGridView1.Rows(counter)
 _
                .Cells("Withdrawals").Value.ToString().Length
 = 0 Then
                withdrawal = Integer.Parse(DataGridView1.Rows(counter)
 _
                    .Cells("Withdrawals").Value.ToString())
            End If
        End If

        DataGridView1.Rows(counter).Cells("Balance").Value
 = _
            (balance + deposit + withdrawal).ToString()
    Next
End Sub

private void DataGridView1_CellValueChanged(
    object sender, DataGridViewCellEventArgs e)
{
    // Update the balance column whenever the value of any cell changes.
    UpdateBalance();
}

private void DataGridView1_RowsRemoved(
    object sender, DataGridViewRowsRemovedEventArgs e)
{
    // Update the balance column whenever rows are deleted.
    UpdateBalance();
}

private void UpdateBalance()
{
    int counter;
    int balance;
    int deposit;
    int withdrawal;

    // Iterate through the rows, skipping the Starting Balance row.
    for (counter = 1; counter < (DataGridView1.Rows.Count -
 1);
        counter++)
    {
        deposit = 0;
        withdrawal = 0;
        balance = int.Parse(DataGridView1.Rows[counter - 1]
            .Cells["Balance"].Value.ToString());

        if (DataGridView1.Rows[counter].Cells["Deposits"].Value
 != null)
        {
            // Verify that the cell value is not an empty string.
            if (DataGridView1.Rows[counter]
                .Cells["Deposits"].Value.ToString().Length != 0)
            {
                deposit = int.Parse(DataGridView1.Rows[counter]
                    .Cells["Deposits"].Value.ToString());
            }
        }

        if (DataGridView1.Rows[counter].Cells["Withdrawals"].Value
 != null)
        {
            if (DataGridView1.Rows[counter]
                .Cells["Withdrawals"].Value.ToString().Length != 0)
            {
                withdrawal = int.Parse(DataGridView1.Rows[counter]
                    .Cells["Withdrawals"].Value.ToString());
            }
        }
        DataGridView1.Rows[counter].Cells["Balance"].Value =
            (balance + deposit + withdrawal).ToString();
    }
}