DataGridViewCellValueEventHandler Делегат

Определение

Предоставляет метод, обрабатывающий событие CellValueNeeded или событие CellValuePushed объекта DataGridView.Represents the method that will handle the CellValueNeeded event or CellValuePushed event of a DataGridView.

public delegate void DataGridViewCellValueEventHandler(System::Object ^ sender, DataGridViewCellValueEventArgs ^ e);
public delegate void DataGridViewCellValueEventHandler(object sender, DataGridViewCellValueEventArgs e);
type DataGridViewCellValueEventHandler = delegate of obj * DataGridViewCellValueEventArgs -> unit
Public Delegate Sub DataGridViewCellValueEventHandler(sender As Object, e As DataGridViewCellValueEventArgs)

Параметры

sender
Object

Источник события.The source of the event.

e
DataGridViewCellValueEventArgs

Объект DataGridViewCellValueEventArgs, содержащий данные события.A DataGridViewCellValueEventArgs that contains the event data.

Наследование
DataGridViewCellValueEventHandler

Примеры

В следующем примере кода CellValuePushed событие обрабатывается для хранения обновлений и новых записей в объекте хранилища данных.The following code example handles the CellValuePushed event to store updates and new entries in a data store object. Этот пример является частью более крупного примера, DataGridView.VirtualMode доступного в справочной статье.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)

Комментарии

Используйте этот делегат для реализации виртуального режима в DataGridView элементе управления.Use this delegate to implement virtual mode in the DataGridView control. Дополнительные сведения о виртуальном режиме см. в разделе виртуальный режим в элементе управления Windows Forms DataGridView.For more information about virtual mode, see Virtual Mode in the Windows Forms DataGridView Control.

При создании делегата DataGridViewCellValueEventHandler необходимо указать метод, обрабатывающий событие.When you create a DataGridViewCellValueEventHandler delegate, you identify the method that will handle the event. Чтобы связать событие с обработчиком событий, нужно добавить в событие экземпляр делегата.To associate the event with your event handler, add an instance of the delegate to the event. Обработчик событий вызывается всякий раз, когда происходит событие, если делегат не удален.The event handler is called whenever the event occurs, unless you remove the delegate. Дополнительные сведения о делегатах обработчиков событий см. в разделе обработка и вызов событий.For more information about event-handler delegates, see Handling and Raising Events.

Методы расширения

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.Gets an object that represents the method represented by the specified delegate.

Применяется к

Дополнительно