DataGridView.BeginEdit(Boolean) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Geçerli hücreyi düzenleme moduna alır.

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

Parametreler

selectAll: Boolean

true hücrenin tüm içeriğini seçmek için; false ögesini seçin.

Döndürülenler

Boolean

true geçerli hücre zaten düzenleme modundaysa veya düzenleme moduna başarıyla giriyorsa; aksi takdirde , false.

Özel durumlar

InvalidOperationException

CurrentCell geçerli bir hücreye ayarlanmadı.

-veya-

Bu yöntem, olay için bir işleyicide CellBeginEdit çağrıldı.

InvalidCastException

Hücrenin EditType özelliği tarafından belirtilen tür türünden Control türetilmez.

-veya-

Hücrenin EditType özelliği tarafından belirtilen tür arabirimi uygulamaz IDataGridViewEditingControl .

Exception

Düzenleme hücresi değeri başlatılamadı ve olay için DataError işleyici yok veya işleyici özelliğini olarak trueayarlamışThrowException. Özel durum nesnesi genellikle türüne FormatExceptionyayınlanabilir.

Örnekler

Aşağıdaki kod örneği bu yöntemin kullanımını gösterir.

// 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

Açıklamalar

Bu yöntem, hücrenin düzenleme moduna girememesi durumunda döndürür false ve bunun çeşitli nedenleri olabilir. Geçerli hücre salt okunursa bu yöntem döndürür false . Ayrıca, hücre EditType özelliği ise null (hücrenin düzenleme denetimini barındıramadığı anlamına gelir) ve hücre türü arabirimi uygulamazsa IDataGridViewEditingCell döndürürfalse.

Hücre düzenlemeyi destekliyorsa, bu yöntem iptal edilebilen olayı başlatır CellBeginEdit ve bir olay işleyicisi düzenlemeyi iptal ederse döndürür false . Düzenleme iptal edilmediyse ve hücre bir düzenleme denetimini barındırabiliyorsa, bu yöntem denetimi başlatır ve görüntüler. Başlatma başarısız olursa, bu yöntem döndürür false.

Hücre düzenleme moduna başarıyla girerse özelliği IsCurrentCellInEditMode döndürür true.

Şunlara uygulanır