DataGridViewCellEventArgs Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewCellEventArgs.cs

Предоставляет данные для событий, DataGridView связанных с операциями ячейки и строк.

public ref class DataGridViewCellEventArgs : EventArgs

public class DataGridViewCellEventArgs : EventArgs

type DataGridViewCellEventArgs = class
    inherit EventArgs

Public Class DataGridViewCellEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

DataGridViewCellEventArgs

Производный

System.Windows.Forms.DataGridViewCellContextMenuStripNeededEventArgs

System.Windows.Forms.DataGridViewCellErrorTextNeededEventArgs

System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs

Примеры

В следующем примере кода показано использование CellMouseEnter и CellMouseLeave обработчики событий, чтобы определить, можно ли щелкнуть ячейку. В примере обновляется каждое ToolTipText значение свойства для объявления текущего макета образа. Этот код является частью более крупного примера, показанного в разделе "Практическое руководство. Работа с столбцами изображений в элементе управления DataGridView в Windows Forms".

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

Комментарии

Класс DataGridViewCellEventArgs предоставляет данные для следующих DataGridView событий:

• CellClick

• CellContentClick

• CellContextMenuStripChanged

• CellEndEdit

• CellEnter

• CellErrorTextChanged

• CellLeave

• CellMouseEnter

• CellMouseLeave

• CellStyleChanged

• CellToolTipTextChanged

• CellValidated

• CellValueChanged

• RowEnter

• RowLeave

• RowValidated

Конструкторы

Имя	Описание
DataGridViewCellEventArgs(Int32, Int32)	Инициализирует новый экземпляр класса DataGridViewCellEventArgs.

Свойства

Имя	Описание
ColumnIndex	Возвращает значение, указывающее индекс столбца ячейки, для которой происходит событие.
RowIndex	Возвращает значение, указывающее индекс строки ячейки, для которой происходит событие.

См. также раздел

• DataGridView
• DataGridViewCellEventHandler