DataGridViewCellValueEventArgs.ColumnIndex プロパティ

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

DataGridViewCellValueEventArgs.ColumnIndex プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

イベントが発生したセルの列インデックスを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 ColumnIndex As Integer

Visual Basic (使用法)

Dim instance As DataGridViewCellValueEventArgs
Dim value As Integer

value = instance.ColumnIndex

C#

public int ColumnIndex { get;
 }

C++

public:
property int ColumnIndex {
    int get ();
}

J#

/** @property */
public int get_ColumnIndex ()

JScript

public function get ColumnIndex
 () : int

プロパティ値
イベントが発生したセルを含む列のインデックス。

解説

このオフセットを Columns プロパティと共に使用して、イベントが発生したセルを参照します。

使用例

次のコード例は、ColumnIndex プロパティを使用してデータ ストアからセル値を取得する方法を示しています。この例は 方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する の例の一部です。

Visual Basic

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

    ' If this is the row for new records, no values are needed.
    If e.RowIndex = Me.dataGridView1.RowCount
 - 1 Then
        Return
    End If

    Dim customerTmp As Customer = Nothing

    ' Store a reference to the Customer object for the row being painted.
    If e.RowIndex = rowInEdit Then
        customerTmp = Me.customerInEdit
    Else
        customerTmp = CType(Me.customers(e.RowIndex), Customer)
    End If

    ' Set the cell value to paint using the Customer object retrieved.
    Select Case Me.dataGridView1.Columns(e.ColumnIndex).Name
        Case "Company Name"
            e.Value = customerTmp.CompanyName

        Case "Contact Name"
            e.Value = customerTmp.ContactName
    End Select

End Sub

C#

private void dataGridView1_CellValueNeeded(object
 sender,
    System.Windows.Forms.DataGridViewCellValueEventArgs e)
{
    // If this is the row for new records, no values are needed.
    if (e.RowIndex == this.dataGridView1.RowCount
 - 1) return;

    Customer customerTmp = null;

    // Store a reference to the Customer object for the row being painted.
    if (e.RowIndex == rowInEdit)
    {
        customerTmp = this.customerInEdit;
    }
    else 
    {
        customerTmp = (Customer)this.customers[e.RowIndex];
    }

    // Set the cell value to paint using the Customer object retrieved.
    switch (this.dataGridView1.Columns[e.ColumnIndex].Name)
    {
        case "Company Name":
            e.Value = customerTmp.CompanyName;
            break;

        case "Contact Name":
            e.Value = customerTmp.ContactName;
            break;
    }
}

プラットフォーム

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 クラス
DataGridViewCellValueEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.Columns プロパティ