DataGridView.ClearSelection Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Cancela la selección de las celdas seleccionadas actualmente.

Sobrecargas

ClearSelection(Int32, Int32, Boolean)	Cancela la selección de todas las celdas seleccionadas actualmente salvo la indicada y, opcionalmente, garantiza que la celda indicada esté seleccionada.
ClearSelection()	Borra la selección actual anulando la selección de todas las celdas seleccionadas.

ClearSelection(Int32, Int32, Boolean)

Cancela la selección de todas las celdas seleccionadas actualmente salvo la indicada y, opcionalmente, garantiza que la celda indicada esté seleccionada.

protected:
 void ClearSelection(int columnIndexException, int rowIndexException, bool selectExceptionElement);

protected void ClearSelection (int columnIndexException, int rowIndexException, bool selectExceptionElement);

member this.ClearSelection : int * int * bool -> unit

Protected Sub ClearSelection (columnIndexException As Integer, rowIndexException As Integer, selectExceptionElement As Boolean)

Parámetros

columnIndexException

Int32

Índice de la columna que se va a excluir.

rowIndexException

Int32

Índice de la fila que se va a excluir.

selectExceptionElement

Boolean

Es true para seleccionar la celda, fila o columna excluida; false para conservar su estado original.

Excepciones

ArgumentOutOfRangeException

columnIndexException es mayor que el índice de columna más alto.

o bien

columnIndexException es menor que -1 cuando SelectionMode es FullRowSelect; de lo contrario, columnIndexException es menor que 0.

o bien

rowIndexException es mayor que el índice de fila más alto.

o bien

rowIndexException es menor que -1 cuando SelectionMode es FullColumnSelect; de lo contrario, rowIndexException es menor que 0.

Comentarios

Un rowIndexException valor de -1 representa un encabezado de columna y un columnIndexException valor de -1 representa un encabezado de fila.

Este método es útil para borrar la selección actual sin cancelar la selección de la celda, fila o columna indicada por los índices de excepción.

Si el valor de la SelectionMode propiedad permite la selección de celda individual, este método establece la Selected propiedad de cada celda falseen , excepto la celda de la fila y la columna especificadas. Si el SelectionMode valor de la propiedad permite la selección completa de filas o columnas, este método también establece la Selected propiedad de cada fila o columna falseen , excepto la fila o columna que contiene la celda especificada.

La celda excluida, fila o columna puede estar o no en el estado seleccionado cuando se llama a este método. Este método lo selecciona si el valor del selectExceptionElement parámetro es true. Según el modo de selección, también se puede seleccionar toda la fila o columna como resultado.

Consulte también

• SelectionMode
• Selected
• Selected
• DataGridView (Control, formularios Windows Forms)

ClearSelection()

Borra la selección actual anulando la selección de todas las celdas seleccionadas.

public:
 void ClearSelection();

public void ClearSelection ();

member this.ClearSelection : unit -> unit

Public Sub ClearSelection ()

Ejemplos

En el ejemplo de código siguiente se borra la selección de DataGridView. Para ejecutar este ejemplo, pegue el código en un formulario que contenga un DataGridView denominado y un Button con nombre dataGridView1clearSelectionButtony asegúrese de que todos los eventos están asociados a sus controladores de eventos.

private void clearSelectionButton_Click(object sender, EventArgs e)
{
    dataGridView1.ClearSelection();
}

Private Sub clearSelectionButton_Click(ByVal sender As Object, _
    ByVal e As EventArgs) Handles clearSelectionButton.Click

    dataGridView1.ClearSelection()

End Sub

Comentarios

Cuando se llama a este método, cada columna y la propiedad de Selected la fila se establecen en false.

Consulte también

• DataGridView (Control, formularios Windows Forms)