DataGridView.BeginEdit(Boolean) Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Pone la celda actual en modo de edición.

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

Parámetros

selectAll
Boolean

Es true para seleccionar todo el contenido de la celda; es false para no seleccionar ningún contenido.

Devoluciones

Boolean

Es true si la celda actual ya está en modo de edición o entra correctamente en el modo de edición; en caso contrario, es false.

Excepciones

InvalidOperationException

CurrentCell no está establecido en una celda válida.

o bien

Se llama a este método en un controlador para el evento CellBeginEdit.

InvalidCastException

El tipo indicado por la propiedad EditType de la celda no se deriva del tipo Control.

o bien

El tipo indicado por la propiedad EditType de la celda no implementa la interfaz IDataGridViewEditingControl.

Exception

Se produjo un error al inicializar el valor de la celda de edición y no hay ningún controlador para el evento DataError o el controlador ha establecido la propiedad ThrowException en true. El objeto de excepción normalmente se puede convertir al tipo FormatException.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este método.

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

Comentarios

Este método devuelve false si la celda no puede entrar en modo de edición, lo que puede ocurrir por varios motivos. Este método devuelve false si la celda actual es de solo lectura. También devuelve false si la propiedad cell EditType es null (lo que significa que la celda no puede hospedar un control de edición) y el tipo de celda no implementa la IDataGridViewEditingCell interfaz.

Si la celda admite la edición, este método genera el CellBeginEdit evento , que se puede cancelar y devuelve false si un controlador de eventos cancela la edición. Si la edición no se cancela y la celda puede hospedar un control de edición, este método inicializa el control y lo muestra. Si se produce un error en la inicialización, este método devuelve false.

Si la celda entra correctamente en modo de edición, la IsCurrentCellInEditMode propiedad devuelve true.

Se aplica a

Consulte también