DataGridView.BeginEdit(Boolean) Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menempatkan sel saat ini dalam mode edit.

public:
 virtual bool BeginEdit(bool selectAll);

public virtual bool BeginEdit (bool selectAll);

abstract member BeginEdit : bool -> bool
override this.BeginEdit : bool -> bool

Public Overridable Function BeginEdit (selectAll As Boolean) As Boolean

Parameter

selectAll: Boolean

true untuk memilih semua konten sel; false untuk tidak memilih konten apa pun.

Mengembalikan

Boolean

true jika sel saat ini sudah dalam mode edit atau berhasil memasuki mode edit; jika tidak, false.

Pengecualian

InvalidOperationException

CurrentCell tidak diatur ke sel yang valid.

-atau-

Metode ini dipanggil dalam handler untuk peristiwa tersebut CellBeginEdit .

InvalidCastException

Jenis yang ditunjukkan oleh properti sel EditType tidak berasal dari Control jenis .

-atau-

Jenis yang ditunjukkan oleh properti sel EditType tidak mengimplementasikan IDataGridViewEditingControl antarmuka.

Exception

Inisialisasi nilai sel pengeditan gagal dan tidak ada penangan untuk DataError peristiwa atau handler telah mengatur properti ke ThrowExceptiontrue. Objek pengecualian biasanya dapat dilemparkan ke jenis FormatException.

Contoh

Contoh kode berikut menunjukkan penggunaan metode ini.

// Override OnMouseClick in a class derived from DataGridViewCell to 
// enter edit mode when the user clicks the cell. 
protected override void OnMouseClick(DataGridViewCellMouseEventArgs e)
{
    if (base.DataGridView != null)
    {
        Point point1 = base.DataGridView.CurrentCellAddress;
        if (point1.X == e.ColumnIndex &&
            point1.Y == e.RowIndex &&
            e.Button == MouseButtons.Left &&
            base.DataGridView.EditMode !=
            DataGridViewEditMode.EditProgrammatically)
        {
            base.DataGridView.BeginEdit(true);
        }
    }
}

' Override OnMouseClick in a class derived from DataGridViewCell to 
' enter edit mode when the user clicks the cell. 
Protected Overrides Sub OnMouseClick( _
    ByVal e As DataGridViewCellMouseEventArgs)

    If MyBase.DataGridView IsNot Nothing Then

        Dim point1 As Point = MyBase.DataGridView.CurrentCellAddress
        If point1.X = e.ColumnIndex And _
            point1.Y = e.RowIndex And _
            e.Button = MouseButtons.Left And _
            Not MyBase.DataGridView.EditMode = _
            DataGridViewEditMode.EditProgrammatically Then

            MyBase.DataGridView.BeginEdit(True)

        End If
    End If
End Sub

Keterangan

Metode ini mengembalikan false jika sel gagal memasuki mode edit, yang dapat terjadi karena sejumlah alasan. Metode ini mengembalikan false jika sel saat ini bersifat baca-saja. Ini juga mengembalikan false jika properti sel EditType ( null artinya sel tidak dapat menghosting kontrol pengeditan) dan jenis sel tidak mengimplementasikan IDataGridViewEditingCell antarmuka.

Jika sel mendukung pengeditan, metode ini akan menaikkan CellBeginEdit acara, yang dapat dibatalkan, dan mengembalikan false jika penanganan aktivitas membatalkan pengeditan. Jika pengeditan tidak dibatalkan dan sel dapat menghosting kontrol pengeditan, metode ini menginisialisasi kontrol dan menampilkannya. Jika inisialisasi gagal, metode ini mengembalikan false.

Jika sel berhasil memasuki mode edit, IsCurrentCellInEditMode properti mengembalikan true.

Berlaku untuk

Share via