DataGridViewCellValueEventArgs Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fournit des données pour les événements CellValueNeeded et CellValuePushed du contrôle DataGridView.

public ref class DataGridViewCellValueEventArgs : EventArgs

public class DataGridViewCellValueEventArgs : EventArgs

type DataGridViewCellValueEventArgs = class
    inherit EventArgs

Public Class DataGridViewCellValueEventArgs
Inherits EventArgs

Héritage

Object

EventArgs

DataGridViewCellValueEventArgs

Exemples

L’exemple de code suivant gère l’événement pour stocker les CellValuePushed mises à jour et les nouvelles entrées dans un objet de magasin de données. Cet exemple fait partie d’un exemple plus vaste disponible dans la rubrique de DataGridView.VirtualMode référence.

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

Remarques

Gérez les CellValueNeeded événements et CellValuePushed pour implémenter le mode virtuel dans le DataGridView contrôle. Pour plus d’informations sur le mode virtuel, consultez Mode virtuel dans le contrôle DataGridView Windows Forms.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

Constructeurs

DataGridViewCellValueEventArgs(Int32, Int32)

Initialise une nouvelle instance de la classe DataGridViewCellValueEventArgs.

Propriétés

ColumnIndex	Obtient une valeur indiquant l'index de colonne de la cellule sur lequel se produit l'événement.
RowIndex	Obtient une valeur indiquant l'index de ligne de la cellule sur lequel se produit l'événement.
Value	Obtient ou définit la valeur de la cellule pour laquelle l'événement se produit.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• DataGridView
• VirtualMode
• CellValueNeeded
• CellValuePushed
• DataGridViewCellValueEventHandler
• Mode virtuel dans le contrôle DataGridView Windows Forms