DataGridViewCellValueEventArgs DataGridViewCellValueEventArgs DataGridViewCellValueEventArgs DataGridViewCellValueEventArgs Class

Определение

Предоставляет данные для событий CellValueNeeded и CellValuePushed элемента управления 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
Наследование
DataGridViewCellValueEventArgsDataGridViewCellValueEventArgsDataGridViewCellValueEventArgsDataGridViewCellValueEventArgs

Примеры

В следующем примере кода обрабатывается 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)

Комментарии

Обрабатывать CellValueNeeded и CellValuePushed событий для реализации виртуальный режим в DataGridView элемента управления.Handle the CellValueNeeded and CellValuePushed events to implement virtual mode in the DataGridView control. Дополнительные сведения о виртуальном режиме, см. в разделе виртуальный режим в элементе управления DataGridView Windows Forms.For more information about virtual mode, see Virtual Mode in the Windows Forms DataGridView Control.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about how to handle events, see Handling and Raising Events.

Конструкторы

DataGridViewCellValueEventArgs(Int32, Int32) DataGridViewCellValueEventArgs(Int32, Int32) DataGridViewCellValueEventArgs(Int32, Int32) DataGridViewCellValueEventArgs(Int32, Int32)

Инициализирует новый экземпляр класса DataGridViewCellValueEventArgs.Initializes a new instance of the DataGridViewCellValueEventArgs class.

Свойства

ColumnIndex ColumnIndex ColumnIndex ColumnIndex

Получает значение, показывающее индекс столбца ячейки, для которой произошло событие.Gets a value indicating the column index of the cell that the event occurs for.

RowIndex RowIndex RowIndex RowIndex

Получает значение, показывающее индекс строки ячейки, для которой произошло событие.Gets a value indicating the row index of the cell that the event occurs for.

Value Value Value Value

Получает или задает значение ячейки, для которой произошло событие.Gets or sets the value of the cell that the event occurs for.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

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