Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método DataGridView.BeginEdit (Boolean)

 

Publicado: octubre de 2016

Pone la celda actual en modo de edición.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public virtual bool BeginEdit(
	bool selectAll
)

Parámetros

selectAll
Type: System.Boolean

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

Valor devuelto

Type: System.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.

Exception Condition
InvalidOperationException

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

-o-

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-

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 DataGridViewDataErrorEventArgs.ThrowException en true. El objeto de excepción normalmente se puede convertir al tipo FormatException.

This method returns false if the cell fails to enter edit mode, which can happen for a number of reasons. This method returns false if the current cell is read-only. It also returns false if the cell P:System.Windows.Forms.DataGridViewCell.EditType property is null (meaning the cell cannot host an editing control) and the cell type does not implement the T:System.Windows.Forms.IDataGridViewEditingCell interface.

If the cell supports editing, this method raises the E:System.Windows.Forms.DataGridView.CellBeginEdit event, which can be canceled, and returns false if an event handler cancels the edit. If the edit is not canceled and the cell can host an editing control, this method initializes the control and displays it. If the initialization fails, this method returns false.

If the cell successfully enters edit mode, the P:System.Windows.Forms.DataGridView.IsCurrentCellInEditMode property returns true.

The following code example demonstrates the use of this method.

// 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);
        }
    }
}

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: