Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
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

DataGridView.BeginEdit (Método)

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)

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.

ExcepciónCondició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.

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.

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


.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, 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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft