DataGridViewCellEventArgs Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewCellEventArgs.cs

Fournit des données pour DataGridView les événements liés aux opérations de cellule et de ligne.

public ref class DataGridViewCellEventArgs : EventArgs

public class DataGridViewCellEventArgs : EventArgs

type DataGridViewCellEventArgs = class
    inherit EventArgs

Public Class DataGridViewCellEventArgs
Inherits EventArgs

Héritage

Object

EventArgs

DataGridViewCellEventArgs

Dérivé

System.Windows.Forms.DataGridViewCellContextMenuStripNeededEventArgs

System.Windows.Forms.DataGridViewCellErrorTextNeededEventArgs

System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs

Exemples

L’exemple de code suivant illustre l’utilisation CellMouseEnter et CellMouseLeave les gestionnaires d’événements pour déterminer si une cellule peut être cliquée. L’exemple met à jour chaque ToolTipText valeur de propriété pour publier la disposition actuelle de l’image. Ce code fait partie d’un exemple plus large présenté dans How to : Work with Image Columns in the Windows Forms DataGridView Control.

void dataGridView1_CellMouseEnter( Object^ sender, DataGridViewCellEventArgs^ e )
{
   Bitmap^ markingUnderMouse = dynamic_cast<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);
   }
}

void ToolTip( DataGridViewCellEventArgs^ e, bool showTip )
{
   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   DataGridViewImageColumn^ imageColumn = dynamic_cast<DataGridViewImageColumn^>(dataGridView1->Columns[ cell->ColumnIndex ]);
   if ( showTip )
         cell->ToolTipText = imageColumn->Description;
   else
   {
      cell->ToolTipText = String::Empty;
   }
}

void dataGridView1_CellMouseLeave( Object^ sender, DataGridViewCellEventArgs^ e )
{
   ToolTip( e, false );
   dataGridView1->Cursor = Cursors::Default;
}

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;
}

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

Remarques

La DataGridViewCellEventArgs classe fournit des données pour les événements suivants DataGridView :

• CellClick

• CellContentClick

• CellContextMenuStripChanged

• CellEndEdit

• CellEnter

• CellErrorTextChanged

• CellLeave

• CellMouseEnter

• CellMouseLeave

• CellStyleChanged

• CellToolTipTextChanged

• CellValidated

• CellValueChanged

• RowEnter

• RowLeave

• RowValidated

Constructeurs

Nom	Description
DataGridViewCellEventArgs(Int32, Int32)	Initialise une nouvelle instance de la classe DataGridViewCellEventArgs.

Propriétés

Nom	Description
ColumnIndex	Obtient une valeur indiquant l’index de colonne de la cellule pour laquelle l’événement se produit.
RowIndex	Obtient une valeur indiquant l’index de ligne de la cellule pour laquelle l’événement se produit.

Voir aussi

• DataGridView
• DataGridViewCellEventHandler