DataGridView.CellValueNeeded Kejadian

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Terjadi ketika VirtualMode properti DataGridView kontrol adalah true dan DataGridView memerlukan nilai untuk sel untuk memformat dan menampilkan sel.

public:
 event System::Windows::Forms::DataGridViewCellValueEventHandler ^ CellValueNeeded;

public event System.Windows.Forms.DataGridViewCellValueEventHandler CellValueNeeded;

member this.CellValueNeeded : System.Windows.Forms.DataGridViewCellValueEventHandler 

Public Custom Event CellValueNeeded As DataGridViewCellValueEventHandler 

Jenis Acara

DataGridViewCellValueEventHandler

Contoh

Contoh kode berikut menangani CellValueNeeded peristiwa untuk mengisi sel dengan bilangan bulat positif. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam VirtualMode topik referensi.

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

Keterangan

Gunakan kejadian ini dalam mode virtual untuk mengisi sel dengan data dari penyimpanan data kustom tanpa menyebabkan baris menjadi tidak dibagikan. Untuk informasi selengkapnya tentang berbagi baris, lihat Praktik Terbaik untuk Menskalakan kontrol Formulir Windows DataGridView. Untuk informasi selengkapnya tentang mode virtual, lihat Mode Virtual di Formulir Windows DataGridView Control.

Untuk menambahkan nilai yang ditentukan pengguna ke penyimpanan data kustom Anda, tangani peristiwa tersebut CellValuePushed .

Untuk informasi selengkapnya tentang cara menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.

Lihat juga

• VirtualMode
• DataGridViewCellValueEventHandler
• DataGridViewCellValueEventArgs
• CellValuePushed
• OnCellValueNeeded(DataGridViewCellValueEventArgs)
• Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView
• Mode Virtual di Formulir Windows Kontrol DataGridView
• Kontrol DataGridView (Formulir Windows)