DataGridViewCellValueEventArgs Classe

Définition

Fournit des données pour les événements CellValueNeeded et CellValuePushed du contrôle DataGridView.Provides data for the CellValueNeeded and CellValuePushed events of the DataGridView control.

public ref class DataGridViewCellValueEventArgs : EventArgs
public class DataGridViewCellValueEventArgs : EventArgs
type DataGridViewCellValueEventArgs = class
    inherit EventArgs
Public Class DataGridViewCellValueEventArgs
Inherits EventArgs
Héritage
DataGridViewCellValueEventArgs

Exemples

L’exemple de code suivant gère l' CellValuePushed événement pour stocker des mises à jour et de nouvelles entrées dans un objet de magasin de données.The following code example handles the CellValuePushed event to store updates and new entries in a data store object. Cet exemple fait partie d’un exemple plus complet disponible dans la DataGridView.VirtualMode rubrique de référence.This example is part of a larger example available in the DataGridView.VirtualMode reference topic.

#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 CellValuePushed événements et pour implémenter le mode virtuel dans le DataGridView contrôle.Handle the CellValueNeeded and CellValuePushed events to implement virtual mode in the DataGridView control. Pour plus d’informations sur le mode virtuel, consultez mode virtuel dans le Windows Forms contrôle DataGridView.For more information about virtual mode, see Virtual Mode in the Windows Forms DataGridView Control.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.For more information about how to handle events, see Handling and Raising Events.

Constructeurs

DataGridViewCellValueEventArgs(Int32, Int32)

Initialise une nouvelle instance de la classe DataGridViewCellValueEventArgs.Initializes a new instance of the DataGridViewCellValueEventArgs class.

Propriétés

ColumnIndex

Obtient une valeur indiquant l'index de colonne de la cellule sur lequel se produit l'événement.Gets a value indicating the column index of the cell that the event occurs for.

RowIndex

Obtient une valeur indiquant l'index de ligne de la cellule sur lequel se produit l'événement.Gets a value indicating the row index of the cell that the event occurs for.

Value

Obtient ou définit la valeur de la cellule pour laquelle l'événement se produit.Gets or sets the value of the cell that the event occurs for.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi