DataGridViewCellValueEventArgsとは何？わかりやすく解説 Weblio辞書

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

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

DataGridViewCellValueEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView コントロールの CellValueNeeded イベントおよび CellValuePushed イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class DataGridViewCellValueEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As DataGridViewCellValueEventArgs

public class DataGridViewCellValueEventArgs
 : EventArgs

C++

public ref class DataGridViewCellValueEventArgs
 : public EventArgs

public class DataGridViewCellValueEventArgs
 extends EventArgs

JScript

public class DataGridViewCellValueEventArgs
 extends EventArgs

解説

CellValueNeeded イベントと CellValuePushed イベントを処理すると、DataGridView コントロールに仮想モードを実装できます。仮想モードの詳細については、「Windows フォーム DataGridView コントロールでの仮想モード」を参照してください。

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

使用例

CellValuePushed イベントを処理して、データストアオブジェクトに更新と新しいエントリを格納するコード例を次に示します。この例は DataGridView.VirtualMode のレファレンストピックで取り上げている例の一部分です。

Visual Basic

#Region "data store maintance"
    Const initialValue As Integer
 = -1

    Private Sub dataGridView1_CellValueNeeded(ByVal
 sender As Object, _
        ByVal e As DataGridViewCellValueEventArgs)
 _
        Handles dataGridView1.CellValueNeeded

        If store.ContainsKey(e.RowIndex) Then
            ' Use the store if the e value has been modified 
            ' and stored.
            e.Value = store(e.RowIndex)
        ElseIf newRowNeeded AndAlso e.RowIndex
 = numberOfRows Then
            If dataGridView1.IsCurrentCellInEditMode Then
                e.Value = initialValue
            Else
                ' Show a blank value if the cursor is just resting
                ' on the last row.
                e.Value = String.Empty
            End If
        Else
            e.Value = e.RowIndex
        End If
    End Sub

    Private Sub dataGridView1_CellValuePushed(ByVal
 sender As Object, _
        ByVal e As DataGridViewCellValueEventArgs)
 _
        Handles dataGridView1.CellValuePushed

        store.Add(e.RowIndex, CInt(e.Value))

    End Sub
#End Region

    Dim store As System.Collections.Generic.Dictionary(Of
 Integer, Integer) = _
        New Dictionary(Of Integer,
 Integer)

#region "data store maintance"
const int initialValue = -1;

private void dataGridView1_CellValueNeeded(object
 sender,
    DataGridViewCellValueEventArgs e)
{
    if (store.ContainsKey(e.RowIndex))
    {
        // Use the store if the e value has been modified 
        // and stored.            
        e.Value = store[e.RowIndex];
    }
    else if (newRowNeeded && e.RowIndex
 == numberOfRows)
    {
        if (dataGridView1.IsCurrentCellInEditMode)
        {
            e.Value = initialValue;
        }
        else
        {
            // Show a blank value if the cursor is just resting
            // on the last row.
            e.Value = String.Empty;
        }
    }
    else
    {
        e.Value = e.RowIndex;
    }
}

private void dataGridView1_CellValuePushed(object
 sender,
    DataGridViewCellValueEventArgs e)
{
    store.Add(e.RowIndex, int.Parse(e.Value.ToString()));
}
#endregion

private Dictionary<int, int>
 store = new Dictionary<int, int>();

C++

#pragma region Data store maintance

    void VirtualConnector::dataGridView1_CellValueNeeded
        (Object^ sender, DataGridViewCellValueEventArgs^ e)
    {
        if (store->ContainsKey(e->RowIndex))
        {
            // Use the store if the e value has been modified 
            // and stored.            
            e->Value = gcnew Int32(store->default[e->RowIndex]);
 
        }
        else if (newRowNeeded && e->RowIndex
 == numberOfRows)
        {
            if (dataGridView1->IsCurrentCellInEditMode)
            {
                e->Value = initialValue;
            }
            else
            {
                // Show a blank e if the cursor is just loitering
                // over(the) last row.
                e->Value = String::Empty;
            }
        }
        else
        {
            e->Value = e->RowIndex;
        }
    }

    void VirtualConnector::dataGridView1_CellValuePushed
        (Object^ sender, DataGridViewCellValueEventArgs^ e)
    {
        String^ value = e->Value->ToString();
        store[e->RowIndex] = Int32::Parse(value, 
            CultureInfo::CurrentCulture);
    }
#pragma endregion

#region "data store maintance"
private final int INITIALVALUE = -1;

private void dataGridView1_CellValueNeeded(Object
 sender,
    DataGridViewCellValueEventArgs e)
{
    if (store.ContainsKey(e.get_RowIndex())) {
        // Use the store if the e value has been modified 
        // and stored.            
        e.set_Value((Int32)store.get_Item(e.get_RowIndex()));
    }
    else {
        if (newRowNeeded && e.get_RowIndex() == numberOfRows)
 {
            if (dataGridView1.get_IsCurrentCellInEditMode()) {
                e.set_Value((Int32)INITIALVALUE);
            }
            else {
                // Show a blank e if the cursor is just loitering
                // over(the)
                // last row.
                e.set_Value("");
            }
        }
        else {
            e.set_Value((Int32)e.get_RowIndex());
        }
    }
} //dataGridView1_CellValueNeeded

private void dataGridView1_CellValuePushed(Object
 sender,
    DataGridViewCellValueEventArgs e)
{
    store.Add(e.get_RowIndex(), Int32.Parse(e.get_Value().ToString()));
} //dataGridView1_CellValuePushed
#endregion

private Dictionary<int, int>
 store = new Dictionary<int, int>();

継承階層

System.Object
System.EventArgs
System.Windows.Forms.DataGridViewCellValueEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
DataGridViewCellValueEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.VirtualMode プロパティ
DataGridView.CellValueNeeded イベント
DataGridView.CellValuePushed イベント
DataGridViewCellValueEventHandler
その他の技術情報
Windows フォーム DataGridView コントロールでの仮想モード

DataGridViewCellValueEventArgs コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridViewCellValueEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    columnIndex As Integer, _
    rowIndex As Integer _
)

Visual Basic (使用法)

Dim columnIndex As Integer
Dim rowIndex As Integer

Dim instance As New DataGridViewCellValueEventArgs(columnIndex,
 rowIndex)

public DataGridViewCellValueEventArgs (
    int columnIndex,
    int rowIndex
)

C++

public:
DataGridViewCellValueEventArgs (
    int columnIndex, 
    int rowIndex
)

public DataGridViewCellValueEventArgs (
    int columnIndex, 
    int rowIndex
)

JScript

public function DataGridViewCellValueEventArgs
 (
    columnIndex : int, 
    rowIndex : int
)

パラメータ

columnIndex: イベントが発生したセルを含む列のインデックス。

rowIndex: イベントが発生したセルを含む行のインデックス。

例外

例外の種類	条件
ArgumentOutOfRangeException	columnIndex が 0 未満です。または rowIndex が 0 未満です。

例外の種類

条件

ArgumentOutOfRangeException

columnIndex が 0 未満です。

または

rowIndex が 0 未満です。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCellValueEventArgs クラス
DataGridViewCellValueEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView クラス
OnCellValueNeeded
OnCellValuePushed

DataGridViewCellValueEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	ColumnIndex	イベントが発生したセルの列インデックスを示す値を取得します。
	RowIndex	イベントが発生したセルの行インデックスを示す値を取得します。
	Value	イベントが発生したセルの値を取得または設定します。

参照

その他の技術情報

Windows フォーム DataGridView コントロールでの仮想モード

DataGridViewCellValueEventArgs メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

Windows フォーム DataGridView コントロールでの仮想モード

DataGridViewCellValueEventArgs メンバ

DataGridView コントロールの CellValueNeeded イベントおよび CellValuePushed イベントのデータを提供します。

DataGridViewCellValueEventArgs データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	DataGridViewCellValueEventArgs	DataGridViewCellValueEventArgs クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	ColumnIndex	イベントが発生したセルの列インデックスを示す値を取得します。
	RowIndex	イベントが発生したセルの行インデックスを示す値を取得します。
	Value	イベントが発生したセルの値を取得または設定します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)