DataGridViewCellValueEventArgs Clase

Definición

Proporciona datos para los eventos CellValueNeeded y CellValuePushed del control 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
Herencia
DataGridViewCellValueEventArgs

Ejemplos

En el ejemplo de código siguiente CellValuePushed se controla el evento para almacenar actualizaciones y entradas nuevas en un objeto de almacén de datos.The following code example handles the CellValuePushed event to store updates and new entries in a data store object. Este ejemplo forma parte de un ejemplo más grande disponible en DataGridView.VirtualMode el tema de referencia.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)

Comentarios

Controle CellValueNeeded los CellValuePushed eventos y para implementar el modo virtual DataGridView en el control.Handle the CellValueNeeded and CellValuePushed events to implement virtual mode in the DataGridView control. Para obtener más información sobre el modo virtual, vea modo virtual en el control DataGridView de Windows Forms.For more information about virtual mode, see Virtual Mode in the Windows Forms DataGridView Control.

Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.For more information about how to handle events, see Handling and Raising Events.

Constructores

DataGridViewCellValueEventArgs(Int32, Int32)

Inicializa una nueva instancia de la clase DataGridViewCellValueEventArgs.Initializes a new instance of the DataGridViewCellValueEventArgs class.

Propiedades

ColumnIndex

Obtiene un valor que indica el índice de columna de la celda para la que se produce el evento.Gets a value indicating the column index of the cell that the event occurs for.

RowIndex

Obtiene un valor que indica el índice de fila de la celda para la que se produce el evento.Gets a value indicating the row index of the cell that the event occurs for.

Value

Obtiene o establece el valor de la celda para la que se produce el evento.Gets or sets the value of the cell that the event occurs for.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: