DataGridView.ClearSelection Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Cancela la selección de celdas seleccionadas actualmente.

Sobrecargas

Nombre	Description
ClearSelection(Int32, Int32, Boolean)	Cancela la selección de todas las celdas seleccionadas actualmente excepto la indicada, lo que 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)

Source:

DataGridView.Methods.cs

Cancela la selección de todas las celdas seleccionadas actualmente excepto la indicada, lo que 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 columna que se va a excluir.

rowIndexException

Int32

Índice de fila que se va a excluir.

selectExceptionElement

Boolean

true para seleccionar la celda, fila o columna excluidas; 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 SelectionMode valor de propiedad permite la selección de celda individual, este método establece la Selected propiedad de cada celda falseen , excluyendo la celda de la fila y la columna especificadas. Si el SelectionMode valor de propiedad permite la selección completa de filas o columnas, este método también establece la Selected propiedad de cada fila o columna en false, excluyendo 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
• Control DataGridView (Formularios Windows Forms)

ClearSelection()

Source:

DataGridView.Methods.cs

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 dataGridView1 y un Button denominado clearSelectionButtony 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 propiedad de Selected columna y fila se establece en false.

Consulte también

• Control DataGridView (Formularios Windows Forms)