DataGridView.BeginEdit(Boolean) Metodo

Definizione

Pone la cella corrente in modalità di modifica.

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

Parametri

selectAll
Boolean

true per selezionare tutto il contenuto della cella, false per non selezionare alcun contenuto.

Restituisce

true se la cella corrente si trova già nella modalità di modifica o il passaggio a tale modalità viene completato; in caso contrario, false.

Eccezioni

CurrentCell non è impostato su una cella valida.

-oppure-

Questo metodo è stato chiamato in un gestore per l'evento CellBeginEdit.

Il tipo indicato dalla proprietà EditType della cella non deriva dal tipo Control.

-oppure-

Il tipo indicato dalla proprietà EditType della cella non implementa l'interfaccia IDataGridViewEditingControl.

L'inizializzazione della modifica del valore di cella non è riuscita e non esiste alcun gestore per l'evento DataError oppure il gestore ha impostato la proprietà ThrowException su true. In genere è possibile eseguire il cast dell'oggetto eccezione al tipo FormatException.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo metodo.

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

Commenti

Questo metodo restituisce false se la cella non riesce a immettere la modalità di modifica, che può verificarsi per diversi motivi. Questo metodo restituisce false se la cella corrente è di sola lettura. Restituisce false anche se la EditType proprietà della cella è null (ovvero la cella non può ospitare un controllo di modifica) e il tipo di cella non implementa l'interfaccia IDataGridViewEditingCell .

Se la cella supporta la modifica, questo metodo genera l'evento CellBeginEdit , che può essere annullato e restituisce false se un gestore eventi annulla la modifica. Se la modifica non viene annullata e la cella può ospitare un controllo di modifica, questo metodo inizializza il controllo e lo visualizza. Se l'inizializzazione ha esito negativo, questo metodo restituisce false.

Se la cella entra correttamente in modalità di modifica, la IsCurrentCellInEditMode proprietà restituisce true.

Si applica a

Vedi anche