DataGridView.BeginEdit(Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Platziert die aktuelle Zelle im Bearbeitungsmodus.
public:
virtual bool BeginEdit(bool selectAll);public virtual bool BeginEdit(bool selectAll);abstract member BeginEdit : bool -> bool
override this.BeginEdit : bool -> boolPublic Overridable Function BeginEdit (selectAll As Boolean) As BooleanParameter
- selectAll
- Boolean
true um alle Inhalte der Zelle auszuwählen; false um keine Inhalte auszuwählen.
Gibt zurück
truewenn sich die aktuelle Zelle bereits im Bearbeitungsmodus befindet oder erfolgreich in den Bearbeitungsmodus wechselt; andernfalls . false
Ausnahmen
CurrentCell ist nicht auf eine gültige Zelle festgelegt.
- oder -
Diese Methode wurde in einem Handler für das CellBeginEdit Ereignis aufgerufen.
Der durch die Eigenschaft der Zelle EditType angegebene Typ wird nicht vom Control Typ abgeleitet.
- oder -
Der durch die Eigenschaft der Zelle EditType angegebene Typ implementiert die IDataGridViewEditingControl Schnittstelle nicht.
Fehler bei der Initialisierung des Bearbeitungszellenwerts, und entweder gibt es keinen Handler für das DataError Ereignis, oder der Handler hat die ThrowException Eigenschaft auf truefestgelegt. Das Ausnahmeobjekt kann in der Regel in den Typ FormatExceptionumwandeln.
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 einer Reihe von Gründen geschehen kann. Diese Methode gibt zurück false , wenn die aktuelle Zelle schreibgeschützt ist. Sie gibt auch zurück false , wenn die Zelleigenschaft EditType ( null d. h. die Zelle kann kein Bearbeitungssteuerelement hosten) 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 die Initialisierung fehlschlägt, gibt falsediese Methode zurück.
Wenn die Zelle erfolgreich in den Bearbeitungsmodus wechselt, wird die IsCurrentCellInEditMode Eigenschaft zurückgegeben true.
