Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.

Traducción

Original

Este tema aún no ha recibido ninguna valoración - Valorar este tema

DataGridView.BeginEdit (Método)

.NET Framework 4.5

Otras versiones

pone a la celda actual en modo de edición.

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

Sintaxis

C++

public virtual bool BeginEdit(
	bool selectAll
)

Parámetros

selectAll: Tipo: System.Boolean
true para seleccionar todo el contenido de celda; false para no seleccionar cualquier contenido.

Valor devuelto

Tipo: System.Boolean
true si la celda actual está en modo de edición o correctamente activa el modo de edición; si no, false.

Excepciones

Excepción	Condición
InvalidOperationException	CurrentCell no se establece una celda válida. - o Este método se llama en un controlador para el evento de CellBeginEdit .
InvalidCastException	El tipo indicado por la propiedad de EditType de celda no deriva del tipo de Control . - o El tipo indicado por la propiedad de EditType de celda no implementa la interfaz de IDataGridViewEditingControl .
Exception	La inicialización del valor de celda de edición que produjo el error y o no hay ningún controlador para el evento de DataError o el controlador ha establecido la propiedad de DataGridViewDataErrorEventArgs.ThrowException a true. El objeto de excepción puede normalmente convertir en el tipo FormatException.

Excepción

Condición

InvalidOperationException

CurrentCell no se establece una celda válida.

- o

Este método se llama en un controlador para el evento de CellBeginEdit .

InvalidCastException

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

- o

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

Exception

La inicialización del valor de celda de edición que produjo el error y o no hay ningún controlador para el evento de DataError o el controlador ha establecido la propiedad de DataGridViewDataErrorEventArgs.ThrowException a true. El objeto de excepción puede normalmente convertir en el tipo FormatException.

Comentarios

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

Si la celda admite la edición, este método genera el evento de CellBeginEdit , que se puede cancelar, y devuelve false si un controlador de eventos cancela la edición. Si la edición no se cancela y puede la celda 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 activa correctamente al modo de edición, la propiedad de IsCurrentCellInEditMode devuelve true.

Ejemplos

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

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Vea también