DataGridViewCellValueEventArgs Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCellValueEventArgs.cs

Poskytuje data pro CellValueNeeded ovládací prvek a CellValuePushed události DataGridView .

public ref class DataGridViewCellValueEventArgs : EventArgs

public class DataGridViewCellValueEventArgs : EventArgs

type DataGridViewCellValueEventArgs = class
    inherit EventArgs

Public Class DataGridViewCellValueEventArgs
Inherits EventArgs

Dědičnost

Object

EventArgs

DataGridViewCellValueEventArgs

Příklady

Následující příklad kódu zpracovává CellValuePushed událost pro ukládání aktualizací a nových položek v objektu úložiště dat. Tento příklad je součástí většího příkladu, který je k dispozici v referenčním DataGridView.VirtualMode tématu.

#pragma region Data store maintance

    void VirtualConnector::dataGridView1_CellValueNeeded
        (Object^ sender, DataGridViewCellValueEventArgs^ e)
    {
        if (store->ContainsKey(e->RowIndex))
        {
            // Use the store if the e value has been modified 
            // and stored.            
            e->Value = gcnew Int32(store->default[e->RowIndex]); 
        }
        else if (newRowNeeded && e->RowIndex == numberOfRows)
        {
            if (dataGridView1->IsCurrentCellInEditMode)
            {
                e->Value = initialValue;
            }
            else
            {
                // Show a blank e if the cursor is just loitering
                // over(the) last row.
                e->Value = String::Empty;
            }
        }
        else
        {
            e->Value = e->RowIndex;
        }
    }

    void VirtualConnector::dataGridView1_CellValuePushed
        (Object^ sender, DataGridViewCellValueEventArgs^ e)
    {
        String^ value = e->Value->ToString();
        store[e->RowIndex] = Int32::Parse(value, 
            CultureInfo::CurrentCulture);
    }
#pragma endregion

#region "data store maintance"
const int initialValue = -1;

private void dataGridView1_CellValueNeeded(object sender,
    DataGridViewCellValueEventArgs e)
{
    if (store.ContainsKey(e.RowIndex))
    {
        // Use the store if the e value has been modified 
        // and stored.            
        e.Value = store[e.RowIndex];
    }
    else if (newRowNeeded && e.RowIndex == numberOfRows)
    {
        if (dataGridView1.IsCurrentCellInEditMode)
        {
            e.Value = initialValue;
        }
        else
        {
            // Show a blank value if the cursor is just resting
            // on the last row.
            e.Value = String.Empty;
        }
    }
    else
    {
        e.Value = e.RowIndex;
    }
}

private void dataGridView1_CellValuePushed(object sender,
    DataGridViewCellValueEventArgs e)
{
    store.Add(e.RowIndex, int.Parse(e.Value.ToString()));
}
#endregion

private Dictionary<int, int> store = new Dictionary<int, int>();

#Region "data store maintance"
    Const initialValue As Integer = -1

    Private Sub dataGridView1_CellValueNeeded(ByVal sender As Object, _
        ByVal e As DataGridViewCellValueEventArgs) _
        Handles dataGridView1.CellValueNeeded

        If store.ContainsKey(e.RowIndex) Then
            ' Use the store if the e value has been modified 
            ' and stored.
            e.Value = store(e.RowIndex)
        ElseIf newRowNeeded AndAlso e.RowIndex = numberOfRows Then
            If dataGridView1.IsCurrentCellInEditMode Then
                e.Value = initialValue
            Else
                ' Show a blank value if the cursor is just resting
                ' on the last row.
                e.Value = String.Empty
            End If
        Else
            e.Value = e.RowIndex
        End If
    End Sub

    Private Sub dataGridView1_CellValuePushed(ByVal sender As Object, _
        ByVal e As DataGridViewCellValueEventArgs) _
        Handles dataGridView1.CellValuePushed

        store.Add(e.RowIndex, CInt(e.Value))

    End Sub
#End Region

    Dim store As System.Collections.Generic.Dictionary(Of Integer, Integer) = _
        New Dictionary(Of Integer, Integer)

Poznámky

Zpracujte události CellValueNeeded pro CellValuePushed implementaci virtuálního režimu v ovládacím DataGridView prvku. Další informace o virtuálním režimu naleznete v tématu Virtuální režim v ovládacím prvku model Windows Forms DataGridView.

Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.

Konstruktory

Name	Description
DataGridViewCellValueEventArgs(Int32, Int32)	Inicializuje novou instanci DataGridViewCellValueEventArgs 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.
Value	Získá nebo nastaví hodnotu buňky, pro kterou nastane událost.

Viz také

• DataGridView
• VirtualMode
• CellValueNeeded
• CellValuePushed
• DataGridViewCellValueEventHandler
• virtuální režim v ovládacím prvku model Windows Forms DataGridView