DataGridViewCellEventArgs Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCellEventArgs.cs

Poskytuje data pro DataGridView události související s operacemi buněk a řádků.

public ref class DataGridViewCellEventArgs : EventArgs

public class DataGridViewCellEventArgs : EventArgs

type DataGridViewCellEventArgs = class
    inherit EventArgs

Public Class DataGridViewCellEventArgs
Inherits EventArgs

Dědičnost

Object

EventArgs

DataGridViewCellEventArgs

Odvozené

System.Windows.Forms.DataGridViewCellContextMenuStripNeededEventArgs

System.Windows.Forms.DataGridViewCellErrorTextNeededEventArgs

System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs

Příklady

Následující příklad kódu ukazuje použití CellMouseEnter a CellMouseLeave obslužné rutiny událostí k určení, zda lze kliknout na buňku. Příklad aktualizuje každou ToolTipText hodnotu vlastnosti, aby inzeruje aktuální rozložení obrázku. Tento kód je součástí většího příkladu uvedeného v části Postupy: Práce se sloupci obrázků v ovládacím prvku Windows Forms DataGridView.

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

Poznámky

Třída DataGridViewCellEventArgs poskytuje data pro následující DataGridView události:

• CellClick

• CellContentClick

• CellContextMenuStripChanged

• CellEndEdit

• CellEnter

• CellErrorTextChanged

• CellLeave

• CellMouseEnter

• CellMouseLeave

• CellStyleChanged

• CellToolTipTextChanged

• CellValidated

• CellValueChanged

• RowEnter

• RowLeave

• RowValidated

Konstruktory

Name	Description
DataGridViewCellEventArgs(Int32, Int32)	Inicializuje novou instanci DataGridViewCellEventArgs třídy.

Vlastnosti

Name	Description
ColumnIndex	Získá hodnotu označující index sloupce buňky, pro kterou nastane událost.
RowIndex	Získá hodnotu označující index řádku buňky, pro kterou nastane událost.

Viz také

• DataGridView
• DataGridViewCellEventHandler