DataGridViewCellValueEventArgs Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

DataGridViewCellValueEventArgs.cs

Adatokat biztosít a CellValueNeeded vezérlőről és CellValuePushed az eseményekről DataGridView .

public ref class DataGridViewCellValueEventArgs : EventArgs

public class DataGridViewCellValueEventArgs : EventArgs

type DataGridViewCellValueEventArgs = class
    inherit EventArgs

Public Class DataGridViewCellValueEventArgs
Inherits EventArgs

Öröklődés

Object

EventArgs

DataGridViewCellValueEventArgs

Példák

Az alábbi példakód kezeli az eseményt, CellValuePushed amely egy adattárobjektumban tárolja a frissítéseket és az új bejegyzéseket. Ez a példa egy nagyobb, a DataGridView.VirtualMode referenciatémában elérhető példa része.

#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)

Megjegyzések

Kezelje a vezérlőben a CellValueNeeded virtuális mód implementálásához szükséges eseményeket és CellValuePushed eseményeket DataGridView . További információ a virtuális módról a Virtuális mód a Windows Forms DataGridView Controlcím alatt található.

Az események kezelésével kapcsolatos további információkért lásd: Események kezelése és emelése.

Konstruktorok

Name	Description
DataGridViewCellValueEventArgs(Int32, Int32)	Inicializálja a DataGridViewCellValueEventArgs osztály új példányát.

Tulajdonságok

Name	Description
ColumnIndex	Lekéri annak a cellának az oszlopindexét jelző értéket, amelynél az esemény bekövetkezik.
RowIndex	Lekéri annak a cellának a sorindexét jelző értéket, amelynél az esemény bekövetkezik.
Value	Lekéri vagy beállítja annak a cellának az értékét, amelynél az esemény bekövetkezik.

Lásd még

• DataGridView
• VirtualMode
• CellValueNeeded
• CellValuePushed
• DataGridViewCellValueEventHandler
• Virtuális mód a Windows Forms DataGridView vezérlőelemben