DataGridView.BeginEdit(Boolean) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs
Quelle:
DataGridView.Methods.cs

Versetzt die aktuelle Zelle in den Bearbeitungsmodus.

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, um den Inhalt der gesamten Zelle auszuwählen, false, um keinen Inhalt auszuwählen.

Gibt zurück

Boolean

true, wenn sich die aktive Zelle bereits im Bearbeitungsmodus befindet oder erfolgreich in den Bearbeitungsmodus wechselt, andernfalls false.

Ausnahmen

InvalidOperationException

CurrentCell ist nicht auf eine gültige Zelle festgelegt.

- oder -

Diese Methode wurde in einem Ereignishandler für das CellBeginEdit-Ereignis aufgerufen.

InvalidCastException

Der von der EditType-Eigenschaft der Zelle angegebene Typ ist nicht vom Control-Typ abgeleitet.

- oder -

Der von der EditType-Eigenschaft der Zelle angegebene Typ implementiert nicht die IDataGridViewEditingControl-Schnittstelle.

Exception

Fehler bei der Initialisierung der Bearbeitung des Zellwerts, und entweder liegt kein Handler für das DataError-Ereignis vor, oder der Handler hat die ThrowException-Eigenschaft auf true festgelegt. Das Ausnahmeobjekt kann in der Regel in den Typ FormatException umgewandelt werden.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Methode veranschaulicht.

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

Hinweise

Diese Methode gibt zurück false , wenn die Zelle nicht in den Bearbeitungsmodus wechselt, was aus verschiedenen Gründen auftreten kann. Diese Methode gibt zurück false , wenn die aktuelle Zelle schreibgeschützt ist. Es wird auch zurückgegeben false , wenn die Zelleigenschaft EditType ist null (was bedeutet, dass die Zelle kein Bearbeitungssteuerelement hosten kann) und der Zelltyp die IDataGridViewEditingCell Schnittstelle nicht implementiert.

Wenn die Zelle die Bearbeitung unterstützt, löst diese Methode das CellBeginEdit Ereignis aus, das abgebrochen werden kann, und gibt zurück false , wenn ein Ereignishandler die Bearbeitung abbricht. Wenn die Bearbeitung nicht abgebrochen wird und die Zelle ein Bearbeitungssteuerelement hosten kann, initialisiert diese Methode das Steuerelement und zeigt es an. Wenn bei der Initialisierung ein Fehler auftritt, gibt diese Methode zurück false.

Wenn die Zelle erfolgreich in den Bearbeitungsmodus wechselt, gibt die IsCurrentCellInEditMode -Eigenschaft zurück true.

Gilt für:

Weitere Informationen