DataGridView.CurrentCellDirtyStateChanged イベント

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

DataGridView.CurrentCellDirtyStateChanged イベント

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

セルの内容の変更に合わせてセルの状態が変化した場合に発生します。

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

Visual Basic (宣言)

Public Event CurrentCellDirtyStateChanged As
 EventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As EventHandler

AddHandler instance.CurrentCellDirtyStateChanged, handler

C#

public event EventHandler CurrentCellDirtyStateChanged

C++

public:
event EventHandler^ CurrentCellDirtyStateChanged {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

J#

/** @event */
public void add_CurrentCellDirtyStateChanged
 (EventHandler value)

/** @event */
public void remove_CurrentCellDirtyStateChanged
 (EventHandler value)

JScript

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

解説

セルの内容が変更され、変更が保存されていない場合、セルは変更済みとしてマークされます。

このイベントは通常、セルが編集され、変更がデータ キャッシュにコミットされていない場合、または編集操作がキャンセルされた場合に発生します。

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

使用例

CurrentCellDirtyStateChanged イベントを処理する方法を次のコード例に示します。この例では、イベント ハンドラは CommitEdit メソッドを呼び出して CellValueChanged イベントを発生させ、DataGridViewCheckBoxCell の現在の値を決定します。次のコード例は、「方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする」で示されている例の一部です。

Visual Basic

' This event handler manually raises the CellValueChanged event
' by calling the CommitEdit method.
Sub dataGridView1_CurrentCellDirtyStateChanged( _
    ByVal sender As Object,
 ByVal e As EventArgs) _
    Handles dataGridView1.CurrentCellDirtyStateChanged

    If dataGridView1.IsCurrentCellDirty Then
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit)
    End If
End Sub

' If a check box cell is clicked, this event handler disables  
' or enables the button in the same row as the clicked cell.
Public Sub dataGridView1_CellValueChanged(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellValueChanged

    If dataGridView1.Columns(e.ColumnIndex).Name = "CheckBoxes"
 Then
        Dim buttonCell As DataGridViewDisableButtonCell
 = _
            CType(dataGridView1.Rows(e.RowIndex).Cells("Buttons"),
 _
            DataGridViewDisableButtonCell)

        Dim checkCell As DataGridViewCheckBoxCell
 = _
            CType(dataGridView1.Rows(e.RowIndex).Cells("CheckBoxes"),
 _
            DataGridViewCheckBoxCell)
        buttonCell.Enabled = Not CType(checkCell.Value, [Boolean])

        dataGridView1.Invalidate()
    End If
End Sub

C#

// This event handler manually raises the CellValueChanged event
// by calling the CommitEdit method.
void dataGridView1_CurrentCellDirtyStateChanged(object sender
,
    EventArgs e)
{
    if (dataGridView1.IsCurrentCellDirty)
    {
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
    }
}

// If a check box cell is clicked, this event handler disables  
// or enables the button in the same row as the clicked cell.
public void dataGridView1_CellValueChanged(object
 sender,
    DataGridViewCellEventArgs e)
{
    if (dataGridView1.Columns[e.ColumnIndex].Name == "CheckBoxes")
    {
        DataGridViewDisableButtonCell buttonCell =
            (DataGridViewDisableButtonCell)dataGridView1.
            Rows[e.RowIndex].Cells["Buttons"];

        DataGridViewCheckBoxCell checkCell =
            (DataGridViewCheckBoxCell)dataGridView1.
            Rows[e.RowIndex].Cells["CheckBoxes"];
        buttonCell.Enabled = !(Boolean)checkCell.Value;

        dataGridView1.Invalidate();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)