DataGridViewCellEventArgs クラス

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

DataGridViewCellEventArgs クラス

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

セルと行の操作に関連する DataGridView イベント向けのデータを提供します。

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

Visual Basic (宣言)

Public Class DataGridViewCellEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As DataGridViewCellEventArgs

C#

public class DataGridViewCellEventArgs : EventArgs

C++

public ref class DataGridViewCellEventArgs
 : public EventArgs

J#

public class DataGridViewCellEventArgs extends
 EventArgs

JScript

public class DataGridViewCellEventArgs extends
 EventArgs

解説

DataGridViewCellEventArgs クラスでは、次の DataGridView イベント向けのデータが提供されます。

• CellClick

• CellContentClick

• CellContextMenuStripChanged

• CellEndEdit

• CellEnter

• CellErrorTextChanged

• CellLeave

• CellMouseEnter

• CellMouseLeave

• CellStyleChanged

• CellToolTipTextChanged

• CellValidated

• CellValueChanged

• RowEnter

• RowLeave

• RowValidated

使用例

CellMouseEnter イベント ハンドラと CellMouseLeave イベント ハンドラを使用して、セルをクリックできるかどうかを確認するコード例を次に示します。この例で ToolTipText プロパティの各値を更新して、現在のイメージのレイアウトをアドバタイズします。ここに示すコードは、「方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する」に示すコードの一部です。

Visual Basic

Private Sub dataGridView1_CellMouseEnter(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellMouseEnter

    Dim markingUnderMouse As Bitmap = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex).Value, Bitmap)

    If markingUnderMouse Is blank Then
        dataGridView1.Cursor = Cursors.Default
    ElseIf markingUnderMouse Is o OrElse
 markingUnderMouse Is x Then
        dataGridView1.Cursor = Cursors.No
        ToolTip(e)
    End If
End Sub

Private Sub ToolTip( _
    ByVal e As DataGridViewCellEventArgs)

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
        Cells(e.ColumnIndex), DataGridViewImageCell)
    Dim imageColumn As DataGridViewImageColumn
 = _
        CType(dataGridView1.Columns(cell.ColumnIndex), _
        DataGridViewImageColumn)

    cell.ToolTipText = imageColumn.Description
End Sub

Private Sub dataGridView1_CellMouseLeave(ByVal
 sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellMouseLeave

    dataGridView1.Cursor = Cursors.Default
End Sub

C#

private void dataGridView1_CellMouseEnter(object
 sender,
    DataGridViewCellEventArgs e)
{
    Bitmap markingUnderMouse = (Bitmap)dataGridView1.
           Rows[e.RowIndex].
           Cells[e.ColumnIndex].Value;

    if (markingUnderMouse == blank)
    {
        dataGridView1.Cursor = Cursors.Default;
    }
    else if (markingUnderMouse == o || markingUnderMouse
 == x)
    {
        dataGridView1.Cursor = Cursors.No;
        ToolTip(e, true);
    }
}

private void ToolTip(DataGridViewCellEventArgs
 e, bool showTip)
{
    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1
        .Rows[e.RowIndex].Cells[e.ColumnIndex];
    DataGridViewImageColumn imageColumn =
        (DataGridViewImageColumn)
        dataGridView1.Columns[cell.ColumnIndex];

    if (showTip) cell.ToolTipText = imageColumn.Description;
    else { cell.ToolTipText = String.Empty; }
}

private void dataGridView1_CellMouseLeave(object
 sender,
    DataGridViewCellEventArgs e)
{
    ToolTip(e, false);
    dataGridView1.Cursor = Cursors.Default;
}

継承階層

System.Object
   System.EventArgs
    System.Windows.Forms.DataGridViewCellEventArgs
       System.Windows.Forms.DataGridViewCellContextMenuStripNeededEventArgs
       System.Windows.Forms.DataGridViewCellErrorTextNeededEventArgs
       System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs

スレッド セーフ

この型の 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

参照

関連項目
DataGridViewCellEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewCellEventHandler