DataGridViewCellEventArgs クラスとは何？わかりやすく解説 Weblio辞書

.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

public class DataGridViewCellEventArgs : EventArgs

C++

public ref class DataGridViewCellEventArgs
 : public EventArgs

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

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